home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / sbbs_116.zip / DOCS.ZIP / SDOC116B.ASC < prev   
Text File  |  1992-05-06  |  234KB  |  5,685 lines
  1.         Chapter 4.     Converting from other software
  2.         ==============================================================
  3.  
  4.         4.1       General information
  5.         --------------------------------------------------------------
  6.  
  7.         SuperBBS is a QuickBBS based bulletin board system. Converting
  8.         from other software to SuperBBS is simple, as long as you use
  9.         a program also based on QuicKBBS. Otherwise a complete
  10.         revision of your menus and textfiles may be needed. For users
  11.         of the RemoteAccess software is a special conversion program
  12.         available.
  13.  
  14.         4.2       Converting from QuickBBS, Proboard or RemoteAccess
  15.         --------------------------------------------------------------
  16.  
  17.         When converting to SuperBBS from QuickBBS or RemoteAccess,
  18.         your userfile, messagebase and most systemfiles can be used by
  19.         SuperBBS. There are some different menu options and some
  20.         controlcodes are not the same. SuperBBS can store it's mes-
  21.         sagebase anywhere you want, which is not available in
  22.         QuickBBS. If you do run into serious trouble converting from
  23.         QuickBBS or RemoteAccess to SuperBBS, contact one of our
  24.         Support nodes or the SuperBBS HQ.
  25.  
  26.         You will need to run USERFIX.EXE on your userfile. This pro-
  27.         gram will scan your userfile so it won't have trouble with the
  28.         7/8 bits characters used in Scandinavian countries. SuperBBS
  29.         fully supports these characters. Put the USERFIX.EXE file in
  30.         the same directory as your USERS.BBS file is and run the
  31.         program.
  32.  
  33.         4.3       Converting from other software
  34.         --------------------------------------------------------------
  35.  
  36.         Converting from other software than QuickBBS, Proboard and
  37.         RemoteAccess is more difficult. Mostly your userbase is not
  38.         compatible and the same is for your messagebase. The SuperBBS
  39.         structures are available, if you need to write conversion
  40.         programs. Most Support boards have these structures available.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.         --------------------------------------------------------------
  58.         SuperBBS v1.16 - Part B                               Page 099
  59.  
  60.  
  61.         Chapter 5.     Menus
  62.         ==============================================================
  63.  
  64.         5.1       General information
  65.         --------------------------------------------------------------
  66.  
  67.         Just like QuickBBS and RemoteAccess is SuperBBS using a menu
  68.         system that requires to be build up from scratch. (Although an
  69.         easy installation program with some simple menus is included.)
  70.         You will have to setup all menus and external screens. Super-
  71.         BBS does include it's own menu program, which has all options
  72.         available. It also supports 'unknown' menu options, so you can
  73.         always use it. At this moment it is the only menu editor which
  74.         supports the multi language options in SuperBBS. Any other
  75.         menu program for QuickBBS is usable, as long as it supports
  76.         'unlisted' menu types, since SuperBBS has more menu options
  77.         than QuickBBS has.
  78.  
  79.         There are several ways to setup a menu system for your BBS.
  80.         The most used one looks like this:
  81.  
  82.                        -------------------- Message menus
  83.                        |
  84.         Main menu ------------------------- File menus
  85.                        |
  86.                        -------------------- Other menus
  87.  
  88.         Another method is to set up your menus by item:
  89.  
  90.         Main menu ------------------------- SuperBBS file & message
  91.                        |
  92.                        |------------------- Modem file & message
  93.                        |
  94.                        -------------------- Graphics file & message
  95.  
  96.         Either way, plan your menu structure carefully. Users like a
  97.         menu structure which is easy to follow.
  98.  
  99.         Building a menu can be done in two ways. You can either build
  100.         the whole menu with the menu editor, so text is displayed if
  101.         needed, or you can start your menu with an ANSI/ASCII display
  102.         option (with Hot-key) which will display the menu and have all
  103.         the commands in the menu file. Both have advantages and disad-
  104.         vantages.
  105.  
  106.         Using an ANSI/ASCII file as menu gives you the advantages that
  107.         you can use more colours on one line, use graphics and even
  108.         animation. Disadvantage is that all menu options will be
  109.         visible to all callers, whatever securitylevel they have. You
  110.         need to setup a display file option with a Crtl-A code, which
  111.         means the command will be executed automatically.
  112.  
  113.  
  114.  
  115.         --------------------------------------------------------------
  116.         SuperBBS v1.16 - Part B                               Page 100
  117.  
  118.  
  119.         Using the normal menu has the advantages that you can hide
  120.         several options from other security levels. Disadvantage is
  121.         the limited use of colour per line. It will be up to you which
  122.         way you choose.
  123.  
  124.         Be sure to check your menu files at every securitylevel you
  125.         have set up. Strange things can happen if you make mistakes.
  126.         Building a menu is simple, building a complex menu with many
  127.         different options for different securitylevels is more diffi-
  128.         cult. Take your time is a good advice.
  129.  
  130.         When building a menu, you will need to enter the following
  131.         information:
  132.  
  133.         Text to display     Text shown to user for this menu option.
  134.                             (Leave this empty if you use an ANSI/ASCII
  135.                             file to display the menu.) This line
  136.                             should contain a description and the char-
  137.                             acter to activate it.
  138.  
  139.         Optional data       Optional data needed for the given menu
  140.                             type command. (See the menu commands.)
  141.  
  142.         Menu type           Number of the menu type. (These will be
  143.                             listed below with a full description and
  144.                             the optional data needed.)
  145.  
  146.         Security            Securitylevel needed to access this menu
  147.                             option.
  148.  
  149.         Key                 Key which activates this menu option. This
  150.                             can be any character on the keyboard.
  151.  
  152.         Foreground          Colour in which the foreground of the text
  153.                             to display will appear. (Options: 0-15)
  154.  
  155.         Background          Colour in which the background of the text
  156.                             to display will appear. (Options: 0-7)
  157.  
  158.         Flags A-D           Flagsettings needed to access this menu
  159.                             option.
  160.  
  161.         Two special options are:
  162.  
  163.         Highlight colour    The highlight colour is a colour
  164.                             which can be displayed on the text to
  165.                             display line through using a '^' in
  166.                             front and behind the text you want
  167.                             'highlighted'.
  168.  
  169.  
  170.  
  171.  
  172.  
  173.         --------------------------------------------------------------
  174.         SuperBBS v1.16 - Part B                               Page 101
  175.  
  176.  
  177.                             An example:
  178.  
  179.                                  Foreground colour:  2
  180.                                  Background colour:  0
  181.                                  Highlight colour...: 14
  182.  
  183.                             Text:   This is a ^test^ for a menu.
  184.                             Result: This is a test for a menu.
  185.  
  186.                             The word 'test' will appear in yellow, the
  187.                             rest of the line in dark green. Note that
  188.                             the special characters are not shown when
  189.                             displaying a menu.
  190.  
  191.         Prompt              Line displayed below the menu options,
  192.                             prompting the user for an action. This
  193.                             line can have a different colour.
  194.  
  195.         Note that the supplied SuperBBS menu editor works a bit diffe-
  196.         rent. But you still have to supply the above information. See
  197.         the external utilities part of the documentation for infor-
  198.         mation on the SuperBBS menu editor.
  199.  
  200.         These descriptions can differ from menu program to menu pro-
  201.         gram, but the main idea stays the same. Use a menu editor
  202.         which has an option for 'unknown' commands, since SuperBBS is
  203.         expanding faster than the menu editors are, so you will be
  204.         able to use the editor in the future.
  205.  
  206.         5.2       Menu commands
  207.         --------------------------------------------------------------
  208.  
  209.         Now for the available menu commands. SuperBBS is pretty power-
  210.         ful and has a lot of features, so read carefully. Make sure
  211.         you take note of any optional data needed to set up a menu
  212.         option. Without this data the menu option will not work or
  213.         behave strangely.
  214.  
  215.         Used characters in the optional data fields:
  216.  
  217.              None    = means no optional data needed
  218.              xxxxxxx = means the data entered here is mandatory.
  219.              <xxxxx> = means the data entered here is optional.
  220.  
  221.         The menu commands:
  222.  
  223.         Type.........: 0
  224.         Description..: Text line
  225.                        Display's the text you've entered in the menu
  226.                        editor for this command. No other action takes
  227.                        place.
  228.         Optional data: None
  229.  
  230.  
  231.         --------------------------------------------------------------
  232.         SuperBBS v1.16 - Part B                               Page 102
  233.  
  234.  
  235.         Type.........: 1
  236.         Description..: Goto a new menu.
  237.                        Will change the menu to the menu set up in the
  238.                        optional data field.
  239.         Optional data: MenuName </F> </M> </NS> </T> </A> <Password>
  240.                        If you want to protect your menu with a pass-
  241.                        word, enter it behind the menu name, separated
  242.                        with a space. Enter the menu name without the
  243.                        .MNU extension. See for the /F and /M the part
  244.                        in this documentation about 'menu templating'.
  245.                        The /NS option will not send a CLS code before
  246.                        displaying the menu. The /T option is used to
  247.                        set opening hours on the menu option. You will
  248.                        have to use it in this way: /T??:??-??:?? The
  249.                        first ??:?? is the start time, the second ??:??
  250.                        is the closing time of the menu option both in
  251.                        24 hour format. When the menu option is closed,
  252.                        a message will be displayed. The /A option is
  253.                        used to set a minimum age for the menu option.
  254.                        You will have to use it in this way: /A???,
  255.                        where ??? is the age. If the user is too young,
  256.                        a message is displayed. The password has to be
  257.                        the last option on the line.
  258.  
  259.         Type.........: 2
  260.         Description..: Gosub to a new menu.
  261.                        Same as option 1, with the difference that the
  262.                        previous menu (the menu you left from) will be
  263.                        added to the stack of menus you've visited.
  264.                        This way you can follow the trail back through
  265.                        your menus.
  266.         Optional data: MenuName </F> </M> </NS> </T> </A> <Password>
  267.                        The same as for menu type 1.
  268.  
  269.         Type.........: 3
  270.         Description..: Return from last gosub.
  271.                        Return to the menu you last visited. This
  272.                        option only works if you use the type 2 menu
  273.                        option to get to a menu.
  274.         Optional data: None or /NS
  275.                        You don't have to enter any menu name, since
  276.                        the stack contains the name of the menu visited
  277.                        last. This name is erased after the return, so
  278.                        you can use menu type 3 again to return to the
  279.                        before last used menu. The /NS option will not
  280.                        send a CLS code before entering the previous
  281.                        menu.
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.         --------------------------------------------------------------
  290.         SuperBBS v1.16 - Part B                               Page 103
  291.  
  292.  
  293.         Type.........: 4
  294.         Description..: Goto new menu and clear gosub stack
  295.                        Clears the gosub stack used with menu options 2
  296.                        and 3. Then goes to the given menu in the
  297.                        optional data field.
  298.         Optional data: MenuName </F> </M> </NS> </T> </A> <Password>
  299.                        The same as for menu type 1
  300.  
  301.         Type.........: 5
  302.         Description..: Display .ANS/.ASC file
  303.                        Display a textfile from the textfile directory
  304.                        setup in CONFIG.EXE and LCONFIG.EXE. SuperBBS
  305.                        first looks in the current language text direc-
  306.                        tory. If not found, SuperBBS will look in the
  307.                        directory specified in CONFIG.EXE. If a user
  308.                        has ANSI on, SuperBBS will first look for an
  309.                        ANS file, then for an ASC file. If the user has
  310.                        ANSI off, SuperBBS only looks for the ASC file.
  311.         Optional data: FileName
  312.                        The filename to be displayed, without exten-
  313.         sion.
  314.  
  315.         Type.........: 6
  316.         Description..: Selection menu
  317.                        Display a textfile which has up to 9 options
  318.                        available of other text files and display the
  319.                        Selection menu prompt, as set up in the
  320.                        CONFIG.EXE program. You will need to name all
  321.                        files the same, except for the last number.
  322.                        Suppose your main file is called BULLET.ANS
  323.                        then your other files will be called
  324.                        BULLET1.ANS to BULLET9.ANS. (If you have 9
  325.                        files.) The main file is shown to the user. The
  326.                        user selects from the list displayed in the
  327.                        main file, which file he/she wants to read. If
  328.                        the user selects 3, the file BULLET3.ANS (or
  329.                        ASC) will be displayed. If the user selects 5,
  330.                        the file BULLET5.ANS will be displayed. After
  331.                        viewing the file, the user will be shown the
  332.                        main file again.
  333.         Optional data: FileName
  334.                        This filename can be 7 characters or less.
  335.                        (Character 8 is reserved for the other textfile
  336.                        numbers.) The extension is always ANS or ASC
  337.                        and the files should be in your textfiles
  338.                        directory.
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.         --------------------------------------------------------------
  348.         SuperBBS v1.16 - Part B                               Page 104
  349.  
  350.  
  351.         Type.........: 7
  352.         Description..: Shell to DOS and run program
  353.                        This option is used for starting other pro-
  354.                        grams, like doorgames and mailscanners, in
  355.                        SuperBBS. It shells to DOS and starts the pro-
  356.                        gram given in the optional data field. SuperBBS
  357.                        will return to the menu the exit started from.
  358.         Optional data: ProgramName <Parameters>
  359.                        This menu is one of the difficult menu options
  360.                        available, because of the large amount of para-
  361.                        meters. These are the parameters available:
  362.  
  363.                        *B   Caller's bps rate. This will be 0 if
  364.                             local, or 300 to 38400 if online.
  365.                        *C   Full path to your COMMAND.COM file as set
  366.                             in the environment variable COMSPEC. (Con-
  367.                             sult your DOS manual for more information
  368.                             about COMSPEC.) This parameter is needed
  369.                             if you want to start a batchfile from this
  370.                             type 7 menu command.
  371.                        *E   Read EXITINFO.BBS when returning to BBS.
  372.                             This can be handy if the program used with
  373.                             the type 7 exit, changes some of the
  374.                             user's data, like a timebank.
  375.                        *F   User's firstname.
  376.                        *G   Status of ANSI graphics. (0=Off, 1=On)
  377.                        *H   Leave the Fossil driver (X00 or
  378.                             compatible) hot when exiting from
  379.                             SuperBBS. Some programs require this.
  380.                             (Most don't.)
  381.                        *I   Path of current language file.
  382.                        *J   User's screenlength
  383.                        *L   User's lastname.
  384.                        *N   Gives current node number.
  385.                        *P   Gives current COM port number.
  386.                        *R   User's recordnumber in the user database.
  387.                        *S   Swap SuperBBS to EMS or disk. If you run a
  388.                             program which needs more memory than the
  389.                             normal amount available, specify the *S
  390.                             option, so SuperBBS will swap itself to
  391.                             EMS or, if EMS is not available, to disk.
  392.                        *T   Time left this call.
  393.                        *U   Path to current template file area. (See
  394.                             menu templating.)
  395.  
  396.                        (Continued on next page)
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.         --------------------------------------------------------------
  406.         SuperBBS v1.16 - Part B                               Page 105
  407.  
  408.  
  409.                        *X   Template filename. SuperBBS now can pro-
  410.                             duce any kind of (ASCII style) exit file,
  411.                             supporting doors not made for SuperBBS.
  412.                             Create a template file with the extension
  413.                             .SBE and set it up as the door might need
  414.                             it. You have all control codes available.
  415.                             When you use the *X option in a type 7
  416.                             exit, SuperBBS will replace the template
  417.                             given in the optional data field, like
  418.                             *XFilename.SBE, to create the exitfile
  419.                             Filename.EXT. Example:
  420.  
  421.                             Exit template file: (TEST.SBE)
  422.  
  423.                                  ^FA
  424.                                  ^FB
  425.                                  ^KO
  426.                                  ^KV
  427.  
  428.                             Would give you an exitfile looking like
  429.                             this: (TEST.EXT)
  430.  
  431.                                  Aki Antman
  432.                                  Helsinki, Finland
  433.                                  45
  434.                                  290
  435.  
  436.                             Being the full username, city, remaining
  437.                             time online and time of next event.
  438.  
  439.                        Mostly you just use the *C and *S parameters.
  440.                        With multi-node operations, you will need the
  441.                        *N and *P options. Normally the documentation
  442.                        from the program you wish to run will supply
  443.                        the needed information.
  444.  
  445.         Type.........: 8
  446.         Description..: Version and copyright notice
  447.                        This option will show the user the version-
  448.                        number, copyright message and if your program
  449.                        is registered, the registration name of the
  450.                        SuperBBS version you're using.
  451.         Optional data: None
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.         --------------------------------------------------------------
  464.         SuperBBS v1.16 - Part B                               Page 106
  465.  
  466.  
  467.         Type.........: 9
  468.         Description..: Logoff from the system
  469.                        This will disconnect the user from your system.
  470.                        Before disconnect, SuperBBS will show the user
  471.                        the GOODBYE.ANS (or ASC) file, if available.
  472.                        When using high speed modems, it might be
  473.                        needed to put a Ctrl-A at the end of the file,
  474.                        otherwise slow modems won't see much of the
  475.                        screen.
  476.         Optional data: None
  477.  
  478.         Type.........: 10
  479.         Description..: Display System Usage graph
  480.                        Show the user the system usage graph. This
  481.                        gives you the percentage use per hour.
  482.         Optional data: None or /H
  483.                        If used with the /H option, SuperBBS will dis-
  484.                        play a horizontal graph, instead of the normal
  485.                        graph.
  486.  
  487.         Type.........: 11
  488.         Description..: Page the Sys(tem)Op(erator) for a chat
  489.                        See if the Sysop is available to talk to you.
  490.                        SuperBBS will ask the user for a reason for the
  491.                        chat. If the Sysop is not available, this rea-
  492.                        son will be stored in the SYSTEM.LOG file.
  493.         Optional data: Prompt </FORCED>
  494.                        Enter the string, which will be shown to users
  495.                        who try to yell you. The /FORCED option will
  496.                        even start the yell outside yelling hours.
  497.                        Useful if you want your co-sysop or special
  498.                        users to call you even outside chat hours.
  499.  
  500.         Type.........: 12
  501.         Description..: Execute questionnaire file
  502.                        Execute the given questionnaire, for example
  503.                        NEWUSER.Q-A. The answers will be written in the
  504.                        same file name as the questionnaire, but the
  505.                        extension will be changed to .ASW.
  506.         Optional data: FileName
  507.                        Extension of a questionnaire must be .Q-A or
  508.                        SuperBBS will not recognize the questionnaire.
  509.                        Answers will be written in the .ASW file.
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.         --------------------------------------------------------------
  522.         SuperBBS v1.16 - Part B                               Page 107
  523.  
  524.  
  525.         Type.........: 13
  526.         Description..: List/search user list
  527.                        Gives the option to search for a name in the
  528.                        userlist or display the whole list.
  529.         Optional data: None, /S or /L
  530.                        If you specify no optional data, the list will
  531.                        contain no security levels. With the /S the
  532.                        securitylevels will be shown to the user. The
  533.                        /L option only shows the users with the same or
  534.                        lower security level.
  535.  
  536.         Type.........: 14
  537.         Description..: Time statistics
  538.                        Shows the user how long he/she has been on-line
  539.                        and how much time is left. Also gives the cur-
  540.                        rent date and time.
  541.         Optional data: None
  542.  
  543.         Type.........: 15
  544.         Description..: Exits to DOS with errorlevel
  545.                        Leaves SuperBBS and returns to the batchfile
  546.                        which you ran SuperBBS from. There you inter-
  547.                        cept the given errorlevel and start an external
  548.                        action. (For more information about error-
  549.                        levels, consult your DOS manual and see the
  550.                        batch examples in the appendixes of this man-
  551.                        ual.) If possible you should use a type 7 exit,
  552.                        instead of this type 15. Use the *S (and *E)
  553.                        when using a type 7.
  554.  
  555.         Optional data: Errorlevel <MenuName>
  556.                        The errorlevel will start the action required
  557.                        from your batchfile. (Don't use errorlevel
  558.                        below 10.) The optional MenuName tells SuperBBS
  559.                        to which menu it should return after ending the
  560.                        type 15 exit. You should restart the SuperBBS
  561.                        program with the -R option. (See Command Line
  562.                        Parameters.)
  563.  
  564.         Type.........: 16
  565.         Description..: Change City & State
  566.                        Allows the user to change his/her City and
  567.                        State.
  568.         Optional data: None
  569.  
  570.         Type.........: 17
  571.         Description..: Change password
  572.                        Allows the user to change his/her Password.
  573.         Optional data: None
  574.  
  575.  
  576.  
  577.  
  578.  
  579.         --------------------------------------------------------------
  580.         SuperBBS v1.16 - Part B                               Page 108
  581.  
  582.  
  583.         Type.........: 18
  584.         Description..: Change screenlength
  585.                        Allows the user to change his/her screenlength.
  586.         Optional data: None
  587.  
  588.         Type.........: 19
  589.         Description..: Toggle screen clearing on/off
  590.                        Allows the user to toggle the sending of screen
  591.                        clear codes (CLS) on and off.
  592.         Optional data: None
  593.  
  594.         Type.........: 20
  595.         Description..: Toggle the 'More (Y/n)' prompt on/off
  596.                        Allows the user to toggle the more prompt on
  597.                        and off.
  598.         Optional data: None
  599.  
  600.         Type.........: 21
  601.         Description..: Toggle ANSI graphics on/off
  602.                        Allows the user to toggle the ANSI graphics on
  603.                        and off.
  604.         Optional data: None
  605.  
  606.         Type.........: 22
  607.         Description..: Scan for personal mail
  608.                        This option will scan the userbase and report
  609.                        any unread personal mail.
  610.         Optional data: None </A> </G>
  611.                        The /A option tells SuperBBS to scan for new
  612.                        normal messages and for new group messages,
  613.                        while the /G option tells SuperBBS to only scan
  614.                        for new group messages. (See the chapter on the
  615.                        messagebase for more information on the group
  616.                        messages.)
  617.  
  618.         Type.........: 23
  619.         Description..: Read messages
  620.                        Allows the user to read messages in the current
  621.                        message area. If a message is private, it will
  622.                        be skipped if it is not from you or to you.
  623.         Optional data: AreaNumber or /M
  624.                        Area number of the message base the messages
  625.                        should be read from. (If you use menu templa-
  626.                        ting, this can also be the templating command
  627.                        /M.)
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.         --------------------------------------------------------------
  638.         SuperBBS v1.16 - Part B                               Page 109
  639.  
  640.  
  641.         Type.........: 24
  642.         Description..: Scan messages
  643.                        Gives a list of messages with the header infor-
  644.                        mation (who from, who to and subject) and gives
  645.                        you the option to mark messages for later read-
  646.                        ing.
  647.         Optional data: Areanumber or /M
  648.                        Area number of the message base the messages
  649.                        should be scanned from.
  650.  
  651.         Type.........: 25
  652.         Description..: Quick scan messages
  653.                        Gives a list like display of all messages in
  654.                        the area with information about the sender,
  655.                        receiver and subject.
  656.         Optional data: AreaNumber or /M
  657.                        Area number of the message base the messages
  658.                        should be scanned from.
  659.  
  660.         Type.........: 26
  661.         Description..: Delete messages
  662.                        Removes messages from the message base. This
  663.                        only works for messages from you or to you.
  664.                        (Unless you have Sysop access to this area.)
  665.         Optional data: AreaNumber or /M
  666.                        Area number of the message base the messages
  667.                        should be deleted from.
  668.  
  669.         Type.........: 27
  670.         Description..: Write a message
  671.                        Allows the user to write a message.
  672.         Optional data: AreaNumber or /M </L> </T=First_Lastname>
  673.                        Area number of the message base to write the
  674.                        message in or the menu templating command /M.
  675.                        The /L will log the user off your system after
  676.                        saving the message (with displaying the file
  677.                        GOODBYE.A??). The /T=First_Lastname will send
  678.                        the message to the name given. Spaces should be
  679.                        set with the underscore character. The /L and
  680.                        /T option only works correct if you use an area
  681.                        number and NOT the /M command. You could use
  682.                        the /L and /T parameters for sending a message
  683.                        to the Sysop at logoff. If you leave this field
  684.                        blank, SuperBBS will use this menu option as an
  685.                        global write option and will ask the user in
  686.                        which area he/she wants to write the message.
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.         --------------------------------------------------------------
  696.         SuperBBS v1.16 - Part B                               Page 110
  697.  
  698.  
  699.         Type.........: 28
  700.         Description..: Select combined message areas
  701.                        Area 0 is a special message area. You can't
  702.                        write a message in this area, but you can read
  703.                        messages from all areas connected in numerical
  704.                        order. This option allows the user to select
  705.                        the areas he/she wants to use in his/her com-
  706.                        bined board. You can select standard areas or
  707.                        exclude areas from the combined board in the
  708.                        CONFIG.EXE program, the Message base part.
  709.         Optional data: None
  710.  
  711.         Type.........: 29
  712.         Description..: Move a file
  713.                        Normally spoken an option only available to the
  714.                        Sysop. It will allow you to move a file from
  715.                        one area to another. It also moves the descrip-
  716.                        tion in the FILES.BBS file.
  717.         Optional data: FullPath or /F
  718.                        You need to give the full directory path from
  719.                        where the file will be moved or the /F if you
  720.                        use menu templating.
  721.  
  722.         Type.........: 30
  723.         Description..: MS-Dos directory
  724.                        Like a normal DIR command, will SuperBBS dis-
  725.                        play the given directory.
  726.         Optional data: FullPath or /F
  727.                        Give the full directory path or the /F.
  728.  
  729.         Type.........: 31
  730.         Description..: List FILES.BBS
  731.                        The normal way to show a user what's available
  732.                        in the given directory. It will show the
  733.                        filename, date, size and description. For CD-
  734.                        Rom users is an option build in to have the
  735.                        FILES.BBS file in a different location then the
  736.                        files itself are. See the CONFIG.EXE program,
  737.                        the File area editor.
  738.                        SuperBBS will ask the user for a file mask to
  739.                        display. There is also an option to only dis-
  740.                        play the newfiles. this is done by entering /N
  741.                        at the filemask question.
  742.         Optional data: FullPath or /F
  743.                        Supply the directory or the /F command. CD-Rom
  744.                        users should use the /F command.
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.         --------------------------------------------------------------
  754.         SuperBBS v1.16 - Part B                               Page 111
  755.  
  756.  
  757.         Type.........: 32
  758.         Description..: Download a file
  759.                        This option will send a file from the BBS to
  760.                        the user.
  761.         Optional data: None <FullPath> </F> <PassWord>
  762.                        If you leave the optional data field empty,
  763.                        SuperBBS will use this command as a global
  764.                        download command. It will search in every area
  765.                        the user has access to, trying to find the
  766.                        requested file. Use the full path or the /F
  767.                        option and SuperBBS will only look in the cur-
  768.                        rent area. The FullPath and /F option allow the
  769.                        use of a password, which need to be given
  770.                        before the download will be started.
  771.  
  772.                        Please note that the <*> option is no longer
  773.                        supported. This is replaced with an option in
  774.                        the FILES.CTL file. Please delete the * from
  775.                        your optional data fields, otherwise SuperBBS
  776.                        will ask for a password before downloading.
  777.  
  778.         Type.........: 33
  779.         Description..: Upload a file
  780.                        This option will receive a file which the user
  781.                        sends to the BBS.
  782.         Optional data: FullPath or /F
  783.                        Supply the full directory or the /F option. By
  784.                        using the full directory command, it is poss-
  785.                        ible to receive all uploads in one directory.
  786.                        The /F will place the file in the current area.
  787.  
  788.         Type.........: 34
  789.         Description..: View an archived file
  790.                        Shows what the archive file contains. It sup-
  791.                        ports ZIP, LZH, PAK and ARC files.
  792.         Optional data: FullPath or /F
  793.                        Supply the full directory path or the /F
  794.                        option.
  795.  
  796.         Type.........: 35
  797.         Description..: Search for file by Keyword
  798.                        Look for a word in the FILES.BBS files.
  799.         Optional data: None
  800.  
  801.         Type.........: 36
  802.         Description..: Search for file by Filename
  803.                        Look for a file in the FILES.BBS files. Wild-
  804.                        cards are allowed as search options.
  805.         Optional data: None
  806.  
  807.  
  808.  
  809.  
  810.  
  811.         --------------------------------------------------------------
  812.         SuperBBS v1.16 - Part B                               Page 112
  813.  
  814.  
  815.         Type.........: 37
  816.         Description..: List new files on system
  817.                        Shows the new files since the last login or the
  818.                        given date. It is also possible to use the new
  819.                        files check since last time viewed. This means
  820.                        that SuperBBS will remember when the user last
  821.                        viewed the new files and will set the date to
  822.                        scan from to that specific date. This option
  823.                        can be configured in the main configuration
  824.                        program. When enabled, this option also works
  825.                        on the new files scan at logon.
  826.         Optional data: None
  827.  
  828.         Type.........: 38
  829.         Description..: Type a textfile
  830.                        Allows the users to read a textfile on-line
  831.                        from your FILES.BBS list. (If there is a text-
  832.                        file in there.)
  833.         Optional data: FullPath or /F
  834.                        Supply full directory path or the /F option.
  835.  
  836.         Type.........: 39
  837.         Description..: Display a textfile
  838.                        Show the user a textfile. This option is like
  839.                        menu option 5, except you have to supply the
  840.                        fullpath and filename. This allows you to show
  841.                        any file you want. No 'Press Return' is given
  842.                        at the end of the file.
  843.         Optional data: Fullpath+FileName
  844.                        Supply the full path and filename to the text-
  845.                        file. Including the extension!
  846.  
  847.         Type.........: 40
  848.         Description..: Display ANS/ASC file with Hotkey
  849.                        Show the user an ANSI or ASCI file, but keep
  850.                        the hot keys active. This can be used to dis-
  851.                        play a menu file. If you use this command to
  852.                        show the file, the user doesn't have to wait
  853.                        till the whole screen is drawn, but can make
  854.                        his choice at once. With a type 5 menu, the hot
  855.                        keys are not active during the display of the
  856.                        file. This command is mostly used in combina-
  857.                        tion with a Crtl-A command in your menu. (Crtl-
  858.                        A = Automatic execution)
  859.         Optional data: FileName
  860.                        Supply the filename to be shown. Don't give an
  861.                        extension, as SuperBBS will always look for a
  862.                        ANS or ASC extension. The file has to be in the
  863.                        textfile directory.
  864.  
  865.  
  866.  
  867.  
  868.  
  869.         --------------------------------------------------------------
  870.         SuperBBS v1.16 - Part B                               Page 113
  871.  
  872.  
  873.         Type.........: 41
  874.         Description..: Toggle Full Screen editor on/off
  875.                        If you have a full screen editor installed,
  876.                        like Quicked, you can allow your users to
  877.                        toggle the editor on and off with this option.
  878.                        If it is off, the build in editor will be used.
  879.         Optional data: None
  880.  
  881.         Type.........: 42
  882.         Description..: RESERVED - Do not use
  883.  
  884.         Type.........: 43
  885.         Description..: RESERVED - Do not use
  886.  
  887.         Type.........: 44
  888.         Description..: RESERVED - Do not use
  889.  
  890.         Type.........: 45
  891.         Description..: Display ANS/ASC file with 'Press ENTER'
  892.                        The same as menu type 5, except that SuperBBS
  893.                        will put a 'Press ENTER to continue' prompt
  894.                        after it showed the file. This will pause the
  895.                        screen till a reaction from the user is
  896.                        received.
  897.         Optional data: FileName or fullpath and filename
  898.                        Supply the filename, without extension. The
  899.                        file has to be in the textfile directory. If
  900.                        you supply the filename and path, you can dis-
  901.                        play any file and have the 'Press Enter' at the
  902.                        end.
  903.  
  904.         Type.........: 46
  905.         Description..: Show GIF pictures resolution
  906.                        Show the resolution of the GIF picture (only of
  907.                        if it is stored on you disk as a .GIF file),
  908.                        which name is supplied by the user. This option
  909.                        doesn't look in archives!
  910.         Optional data: FullPath or /F
  911.                        Supply the full directory path or use the /F
  912.                        option.
  913.  
  914.         Type.........: 47
  915.         Description..: Write entry to System log
  916.                        Write the text, given in the optional data
  917.                        field, to the SYSTEM.LOG file. This is handy if
  918.                        you want to know if a menu option is used or
  919.                        for any other information.
  920.         Optional data: Text to be written
  921.                        The text given in this field will be written to
  922.                        the system logfile.
  923.  
  924.  
  925.  
  926.  
  927.         --------------------------------------------------------------
  928.         SuperBBS v1.16 - Part B                               Page 114
  929.  
  930.  
  931.         Type.........: 48
  932.         Description..: Download a specific file
  933.                        By using this option, you only ask the user
  934.                        which download protocol he/she wants to use and
  935.                        then starts the download. You supplied the
  936.                        filename in the optional data field. This can
  937.                        be used to download your ALLFILES list.
  938.         Optional data: FullPath+FileName
  939.                        Supply the file the users can download through
  940.                        the use of this option.
  941.  
  942.         Type.........: 49
  943.         Description..: RESERVED - Do not use
  944.  
  945.         Type.........: 50
  946.         Description..: RESERVED - Do not use
  947.  
  948.         Type.........: 51
  949.         Description..: RESERVED - Do not use
  950.  
  951.         Type.........: 52
  952.         Description..: RESERVED - Do not use
  953.  
  954.         Type.........: 53
  955.         Description..: Toggle mailcheck at logon on/off
  956.                        Allows the user to toggle the mailcheck at
  957.                        logon on and off.
  958.         Optional data: None
  959.  
  960.         Type.........: 54
  961.         Description..: Toggle newfiles check at logon on/off
  962.                        Allows the user to toggle the newfiles check at
  963.                        logon on or off.
  964.         Optional data: None
  965.  
  966.         Type.........: 55
  967.         Description..: Show BBS list (Short)
  968.                        Shows the user the build in BBS list in the
  969.                        short version.
  970.         Optional data: None
  971.  
  972.         Type.........: 56
  973.         Description..: Add BBS to BBS list
  974.                        Allows Sysops to add their BBS to your BBS
  975.                        list. Information like telephone number, name,
  976.                        on-line hours, software and Sysop name are
  977.                        stored.
  978.         Optional data: None
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.         --------------------------------------------------------------
  986.         SuperBBS v1.16 - Part B                               Page 115
  987.  
  988.  
  989.         Type.........: 57
  990.         Description..: Leave comment to next user
  991.                        A comment of 2 lines can be left behind for the
  992.                        next user. This will be shown to the next
  993.                        caller at logon. The user will not be logged
  994.                        off after entering the comment.
  995.         Optional data: None
  996.  
  997.         Type.........: 58
  998.         Description..: Show callers
  999.                        Gives a list of the last 15 callers with the
  1000.                        time they came on-line and went off-line. Also
  1001.                        shown are bps rates and age.
  1002.         Optional data: None or /T
  1003.                        If no optional data is specified the list will
  1004.                        display the last 15 callers of all available
  1005.                        lines. With the /T option, the list will con-
  1006.                        tain all callers since midnight.
  1007.  
  1008.                        Please note that the filename for this option
  1009.                        has changed. The file used is now called
  1010.                        SCALLERS.BBS and the old file SLCALLER.BBS is
  1011.                        no longer used and can be deleted.
  1012.  
  1013.         Type.........: 59
  1014.         Description..: Change colour configuration
  1015.                        Allows the user to change the colour configur-
  1016.                        ation of the BBS. This is the same as in the
  1017.                        CONFIG.EXE program, but only works for the
  1018.                        current user, while the CONFIG.EXE part, works
  1019.                        for every user.
  1020.         Optional data: None
  1021.  
  1022.         Type.........: 60
  1023.         Description..: Extract files
  1024.                        Allows the user to extract a file, then after-
  1025.                        wards he/she can view the files inside the
  1026.                        archive and repack (some) files. All from with-
  1027.                        in SuperBBS.
  1028.         Optional data: None <FullPath> </F>
  1029.                        If you leave the optional data line empty, it
  1030.                        means extract the file which is IN the TEMP
  1031.                        directory. This TEMP directory is setup in the
  1032.                        CONFIG.EXE program. If you enter the full
  1033.                        directory path or the /F, for menu templating,
  1034.                        this menu type will react as extract TO the
  1035.                        TEMP directory. Note the difference!
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.         --------------------------------------------------------------
  1044.         SuperBBS v1.16 - Part B                               Page 116
  1045.  
  1046.  
  1047.         Type.........: 61
  1048.         Description..: Archive files
  1049.                        The user will be asked which files have to be
  1050.                        archived. This option is to be used with the
  1051.                        extract option, menu type 60.
  1052.         Optional data: FullPath or /F
  1053.                        If you enter the full directory path of the
  1054.                        TEMP dir, the files will be packed from that
  1055.                        area. If you use the /F or the full directory
  1056.                        path to your file areas, the requested files
  1057.                        from that area will be packed.
  1058.  
  1059.         Type.........: 62
  1060.         Description..: Delete files
  1061.                        The user will be asked which files have to be
  1062.                        deleted. This option is to be used with the
  1063.                        extract option, menu type 60.
  1064.         Optional data: FullPath or /F
  1065.                        If you enter the full directory path of the
  1066.                        TEMP dir, the files will be deleted from that
  1067.                        area. If you use the /F or the full directory
  1068.                        path to your file areas, the requested files
  1069.                        from that area will be deleted.
  1070.  
  1071.         Type.........: 63
  1072.         Description..: Show BBS list (Long)
  1073.                        Show the user the long version of the BBS list.
  1074.                        The user has the option to enter the name
  1075.                        he/she wants to look for. All available data
  1076.                        about the BBS will be shown.
  1077.         Optional data: None
  1078.  
  1079.         Type.........: 64
  1080.         Description..: Change BBS information in BBS list
  1081.                        Allows Sysops to change their BBS data in the
  1082.                        BBS list. Only you and the person named as
  1083.                        Sysop in the BBS list is able to do this.
  1084.         Optional data: None
  1085.  
  1086.         Type.........: 65
  1087.         Description..: Delete BBS information from BBS list
  1088.                        Allows Sysop to remove their data from the BBS
  1089.                        list. Only you and the person named as Sysop in
  1090.                        the BBS list is able to do this.
  1091.         Optional data: None
  1092.  
  1093.         Type.........: 66
  1094.         Description..: Download BBS list
  1095.                        Allows users to download the BBS list. Only the
  1096.                        protocol will be asked for.
  1097.         Optional data: None
  1098.  
  1099.  
  1100.  
  1101.         --------------------------------------------------------------
  1102.         SuperBBS v1.16 - Part B                               Page 117
  1103.  
  1104.  
  1105.         Type.........: 67
  1106.         Description..: Change user's phone number(s)
  1107.                        Allows the user to change his/her phone num-
  1108.                        ber(s).
  1109.         Optional data: None, /V or /D
  1110.                        The /V for Voice and the /D for Data numbers
  1111.                        can be used if you don't want SuperBBS to ask
  1112.                        the user for both telephone numbers. /V will
  1113.                        only ask for the voice number and /D will only
  1114.                        ask for the data phone number.
  1115.  
  1116.         Type.........: 68
  1117.         Description..: Select message area from arealist
  1118.                        Allows the user to change area with the build
  1119.                        in area change command. This will display a
  1120.                        two row list of all the available (to this
  1121.                        user) message areas. Use this for changing
  1122.                        areas when using menu templating.
  1123.         Optional data: None, /3, /N or /G=?
  1124.                        When no option is given, SuperBBS will show all
  1125.                        mail areas to the user to which he/she has
  1126.                        access. When the /G option is used in conjunc-
  1127.                        tion with a message group character, SuperBBS
  1128.                        will only show the mail areas belonging to that
  1129.                        group. For example /G=L will only show the
  1130.                        areas belonging to mailgroup L (as specified in
  1131.                        the area setup).
  1132.                        The /N option will ask directly for the area-
  1133.                        number, without showing the area list first.
  1134.                        Users who know which area to go will benefit
  1135.                        from the speed. Users who don't know which area
  1136.                        they want can just press ENTER and SuperBBS
  1137.                        will show the arealist.
  1138.                        The /3 option will show the arealist as it was
  1139.                        in SuperBBS before version 1.16. (Version 1.16
  1140.                        and up uses a standard 2 collum display.) You
  1141.                        will get three collum of areas with the /3
  1142.                        option. Please note that areanames should not
  1143.                        exceed 20 characters when using this option.
  1144.                        There is also an option to use an ANS/ASC file
  1145.                        for displaying the areanames. See for more
  1146.                        information the MSGAREA.A?? file. If this file
  1147.                        is found, SuperBBS will use this textfile
  1148.                        instead of the build in arealist.
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.         --------------------------------------------------------------
  1160.         SuperBBS v1.16 - Part B                               Page 118
  1161.  
  1162.  
  1163.         Type.........: 69
  1164.         Description..: Select file area from arealist
  1165.                        Allows users to change area with the build in
  1166.                        area change command. This will display a one
  1167.                        row list of all the available (to this user)
  1168.                        file areas. Use this for changing areas when
  1169.                        using menu templating.
  1170.         Optional data: None, /P or /2
  1171.                        If you use the /P, the change area command will
  1172.                        change into a pick area command for ANSI users
  1173.                        only. The user can select an area from the list
  1174.                        with the cursor control keys. Local users
  1175.                        should use the cursor control keys on the
  1176.                        numeric keyboard with NUMLOCK on. (The other
  1177.                        cursor keys are used to change the online
  1178.                        time). The /2 command will give you two rows
  1179.                        instead of the one single row when no optional
  1180.                        data is given. With this option, your area
  1181.                        names have to be shorter than 30 characters,
  1182.                        but it allows you to display twice as much
  1183.                        areas on screen at once.
  1184.  
  1185.         Type.........: 70
  1186.         Description..: Change alias
  1187.                        Allows the user to change his/her alias. Only
  1188.                        works if you allowed the use of an alias on
  1189.                        your system.
  1190.         Optional data: None
  1191.  
  1192.         Type.........: 71
  1193.         Description..: List aliases
  1194.                        Shows an user - alias list of all users. The
  1195.                        user is given the option to select a search
  1196.                        criterium.
  1197.         Optional data: None
  1198.  
  1199.         Type.........: 72
  1200.         Description..: Show user's balance in the timebank
  1201.                        Allows the user to see how much time he/she has
  1202.                        deposit in the timebank. You can set a maximum
  1203.                        in the CONFIG.EXE program.
  1204.         Optional data: None
  1205.  
  1206.         Type.........: 73
  1207.         Description..: Deposit time in timebank
  1208.                        Allows the user to store time in the timebank.
  1209.         Optional data: None
  1210.  
  1211.         Type.........: 74
  1212.         Description..: Withdraw time from timebank
  1213.                        Allows the user to withdraw time from his/her
  1214.                        account.
  1215.         Optional data: None
  1216.  
  1217.         --------------------------------------------------------------
  1218.         SuperBBS v1.16 - Part B                               Page 119
  1219.  
  1220.  
  1221.         Type.........: 75
  1222.         Description..: User online / Other line status
  1223.                        Show's who is on the other line(s) or the cur-
  1224.                        rent status of the other line(s).
  1225.         Optional data: None </S>
  1226.                        If you leave the optional data field empty,
  1227.                        SuperBBS will show the user who is on the other
  1228.                        line(s). If you use the /S parameter, SuperBBS
  1229.                        will show you the status of the other line(s).
  1230.  
  1231.         Type.........: 76
  1232.         Description..: Send message to other user on-line
  1233.                        Allows the user on a line to send a on-line
  1234.                        message to a user on another line. This only
  1235.                        works if the 'Do not disturb' flag is not on.
  1236.         Optional data: None
  1237.  
  1238.         Type.........: 77
  1239.         Description..: Change current language
  1240.                        Allows the user to change his/her current lan-
  1241.                        guage file. (If you run with more than one
  1242.                        language file.)
  1243.         Optional data: None
  1244.  
  1245.         Type.........: 78
  1246.         Description..: Toggle 'Do not disturb' on/off
  1247.                        Allows the user to toggle the 'Do not disturb'
  1248.                        flag on and off. This way he/she can prevent
  1249.                        receiving messages from other line users.
  1250.         Optional data: None
  1251.  
  1252.         Type.........: 79
  1253.         Description..: Toggle full-screen message viewer on/off
  1254.                        Allows the user to toggle in SuperBBS the full-
  1255.                        screen message reader on or off. Quotes are now
  1256.                        written in a different colour when messages are
  1257.                        viewed with the fullscreen message viewer.
  1258.         Optional data: None
  1259.  
  1260.         Type.........: 80
  1261.         Description..: Displays mail areas with unread mail. All areas
  1262.                        which contains mail not yet read by the user
  1263.                        will be displayed. The menu option also tells
  1264.                        the user how many messages are unread and if
  1265.                        there are any personal unread messages.
  1266.         Optional data: None or /C
  1267.                        The /C option works on the user selected com-
  1268.                        bined boards (Message board 0). If you leave
  1269.                        the optional data field empty, it works on all
  1270.                        file areas.
  1271.  
  1272.  
  1273.  
  1274.  
  1275.         --------------------------------------------------------------
  1276.         SuperBBS v1.16 - Part B                               Page 120
  1277.  
  1278.  
  1279.         Type.........: 81
  1280.         Description..: This menu option allows the user to scan a file
  1281.                        for a virus infection. SuperBBS normally scans
  1282.                        uploads for viruses (if enabled), but now the
  1283.                        user can enter a filename of the file he/she
  1284.                        wants to scan. You will need the known ar-
  1285.                        chivers and the SCAN virusscanner somewhere in
  1286.                        your path.
  1287.         Optional data: /F or Full path
  1288.  
  1289.         Type.........: 82
  1290.         Description..: Allows the user to download the messages in the
  1291.                        QWK format, so he/she is able to read them
  1292.                        offline at his/her own pace.
  1293.         Optional data: None
  1294.  
  1295.         Type.........: 83
  1296.         Description..: Upload option for replies on the QWK messages
  1297.                        downloaded with the menu option 82. The upload
  1298.                        is done in a .REP file, which SuperBBS will
  1299.                        extract and than place the messages contained
  1300.                        in the .REP file in the correct areas, or the
  1301.                        default QWK area.
  1302.         Optional data: None
  1303.  
  1304.         Type.........: 84
  1305.         Description..: Allows the user to update his/her lastread
  1306.                        pointer, telling SuperBBS where to start
  1307.                        searching for new messages when downloading a
  1308.                        QWK packet.
  1309.         Optional data: None
  1310.  
  1311.         Type.........: 85
  1312.         Description..: Show an aphorism to the user. An aphorism, also
  1313.                        called 'fortune cookie' is a little text which
  1314.                        is funny or interesting or just a text. (Like
  1315.                        the laws of Murphy.) SuperBBS will randomly
  1316.                        display an aphorism from a file given in the
  1317.                        optional data field. This file has to be in a
  1318.                        certain format:
  1319.  
  1320.                             **
  1321.                             Life is great if you run SuperBBS!
  1322.                                  By: Frank Hemmelder
  1323.                             **
  1324.                             SuperBBS is now bugfree!
  1325.                                  By Aki Antman
  1326.  
  1327.                             SYSTEM ERROR: Disconnecting
  1328.                             **
  1329.  
  1330.  
  1331.  
  1332.  
  1333.         --------------------------------------------------------------
  1334.         SuperBBS v1.16 - Part B                               Page 121
  1335.  
  1336.  
  1337.                        The ** has to be the first two characters on
  1338.                        the line. They separate the aphorisms from each
  1339.                        other.
  1340.  
  1341.                        The ANSI/ASCII file APHORISM.A?? is displayed
  1342.                        before the aphorism itself. You can use all
  1343.                        control codes in the aphorism file, like all
  1344.                        colour codes and other options.
  1345.         Optional data: Drive:\Fullpath\Filename.ext (and /N)
  1346.                        The /N will suppress the 'press ENTER' line
  1347.                        after the aphorism is shown.
  1348.  
  1349.         Type.........: 86
  1350.         Description..: Execute the doornumber in the optional data
  1351.                        field or the current door in the configuration
  1352.                        program.
  1353.         Optional data: Doornumber or /D
  1354.                        When using the door template menu, use the /D
  1355.                        option to execute the door. When you want to
  1356.                        start a specific door, use the doornumber as
  1357.                        setup in the configuration menu. SuperBBS will
  1358.                        save the door information, so the user will be
  1359.                        returned to the same door the next time he
  1360.                        chooses the door menu.
  1361.  
  1362.         Type.........: 87
  1363.         Description..: Select a door from the list. Use this command
  1364.                        when working with the door template menu as set
  1365.                        in the configuration. This option will display
  1366.                        a list of all available (to the user) doors. If
  1367.                        his/her security is too low, or the user
  1368.                        doesn't have the correct flagsetting for a
  1369.                        door, this door won't be displayed in the list.
  1370.         Optional data: None or /R
  1371.                        The /R option will execute the selected door
  1372.                        automatically. this option is useful for pro-
  1373.                        grams which do not need a menu, but can be run
  1374.                        at once. Without the /R option, SuperBBS will
  1375.                        change to the template menu for the selected
  1376.                        door.
  1377.  
  1378.         Type.........: 88
  1379.         Description..: Browse the nodelist menu option. this allows
  1380.                        you and your users to search through the node-
  1381.                        lists, when compiled, for a certain address.
  1382.                        You will have to compile the nodelist with the
  1383.                        SBBSNODE.EXE program. (See the chapter on util-
  1384.                        ities.) This is the format when viewing:
  1385.  
  1386.                        Z         = Display list of zones
  1387.                        2:?       = Display nets in zone 2
  1388.                        220/?     = Display nodes in net 220
  1389.         Optional data: None
  1390.  
  1391.         --------------------------------------------------------------
  1392.         SuperBBS v1.16 - Part B                               Page 122
  1393.  
  1394.  
  1395.         Type.........: 89
  1396.         Description..: This menu command is an area by area read com-
  1397.                        mand. You can read all unread messages in all
  1398.                        areas on behind each other. If there are no new
  1399.                        messages, SuperBBS will search for the next
  1400.                        area with new messages. You can always stop
  1401.                        reading after a message by pressing the corre-
  1402.                        sponding key for the Stop command. There is
  1403.                        also a command available to go to the next
  1404.                        area.
  1405.         Optional data: None
  1406.  
  1407.         Type.........: 90
  1408.         Description..: Attach a file to another user. This way a user
  1409.                        can send a file to another user. If local, the
  1410.                        file will be copied to the correct place, after
  1411.                        SuperBBS prompts for the filename. When used
  1412.                        remote, the user can upload the file by using
  1413.                        any protocol. This menu option allows the
  1414.                        transfer of the files privately. SuperBBS will
  1415.                        store the files in the Local Attach area, set
  1416.                        in the configuration program. (The LA directory
  1417.                        in the directory configuration.)
  1418.         Optional data: None or message area number
  1419.                        When using the optional message area number,
  1420.                        the user can leave a message to the receiver of
  1421.                        the file, telling him/her about the file. If no
  1422.                        optional area number is used, there is no mess-
  1423.                        age attach option for the user.
  1424.  
  1425.         Type.........: 91
  1426.         Description..: Check if the current user has some attached
  1427.                        files waiting. If there are files waiting, the
  1428.                        user will be told so and given the option to
  1429.                        download them. You can enable/disable the check
  1430.                        on local attach files from the configuration
  1431.                        program.
  1432.         Optional data: None
  1433.  
  1434.         Type.........: 92
  1435.         Description..: Select the archiver the user wants to use to
  1436.                        archive the .QWK packet with. Used with menu
  1437.                        option 82 and 83.
  1438.         Optional data: None
  1439.  
  1440.         Type.........: 93
  1441.         Description..: Sysop download function. This function allows
  1442.                        you to download a file from anywhere on the
  1443.                        system(s). There are absolutely no restric-
  1444.                        tions, so use this option with care.
  1445.         Optional data: None
  1446.  
  1447.  
  1448.  
  1449.         --------------------------------------------------------------
  1450.         SuperBBS v1.16 - Part B                               Page 123
  1451.  
  1452.  
  1453.         Type.........: 94
  1454.         Description..: Show users age graph. It will generate a graph
  1455.                        of all the users ages.
  1456.         Optional data: None or /S=?
  1457.                        When no optional data is given, SuperBBS will
  1458.                        start the graph at the age specified in the
  1459.                        configuration program. If the /S=? is used, you
  1460.                        can select at which age to start the graph, by
  1461.                        changing the parameter. For example /S=34 will
  1462.                        start the agegraph at the age of 34.
  1463.  
  1464.         Type.........: 95
  1465.         Description..: This menu command is used to either remove
  1466.                        files from the list of flagged files and to
  1467.                        show the flagged files in listform.
  1468.         Optional data: /S or None
  1469.                        When used with no optional data, this command
  1470.                        means remove a file from the flagged files
  1471.                        list. With the /S command it means that Super-
  1472.                        BBS will show the flagged files.
  1473.  
  1474.         Type.........: 96
  1475.         Description..: Use selected 'combined' mail areas or use all
  1476.                        mail areas in the mail check. With this menu
  1477.                        option you can switch between the two options.
  1478.         Optional data: None
  1479.  
  1480.         Type.........: 97
  1481.         Description..: Select default protocol. SuperBBS now allows you
  1482.                        to have a default protocol. This protocol will
  1483.                        be used for all transfers.
  1484.         Optional data: None
  1485.  
  1486.         Type.........: 98
  1487.         Description..: Toggle hotkeys on or off. Use this command to
  1488.                        allow your users to toggle the hotkey, that is
  1489.                        pressing a menu key will give a reaction with-
  1490.                        out having to press ENTER or no hotkeys, which
  1491.                        means you have to press ENTER after each com-
  1492.                        mand.
  1493.         Optional data: None
  1494.  
  1495.         Type.........: 99
  1496.         Description..: Chat between nodes. See also menu type 100 on
  1497.                        how to start a nodechat.
  1498.         Optional data: None
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.         --------------------------------------------------------------
  1508.         SuperBBS v1.16 - Part B                               Page 124
  1509.  
  1510.  
  1511.         Type.........: 100
  1512.         Description..: Create a conference for group chats. When a
  1513.                        user wants to use groupchat, he/she has to
  1514.                        create a (temporary) conference, which other
  1515.                        users can join. When the last user exits from
  1516.                        the conference, the conference is deleted.
  1517.                        (Only persons with Sysop level are able to make
  1518.                        conferences which are not deleted when the last
  1519.                        user logs off from the conference.) You should
  1520.                        have at least one permanent conference.
  1521.         Optional data: None or /D
  1522.                        When no optional data is given, a conference is
  1523.                        generated. When the /D option is given, a con-
  1524.                        ference can be deleted. (Except for permanent
  1525.                        conferences, which can only be deleted by
  1526.                        people with Sysop access.)
  1527.  
  1528.         That's it, all available menu commands. If you are convert-
  1529.         ing from RemoteAccess, Proboard or QuickBBS to SuperBBS remem-
  1530.         ber that there are different options available in SuperBBS,
  1531.         which the others do not have. Please check your configuration
  1532.         carefully if starting with SuperBBS.
  1533.  
  1534.         5.3       Menu templating
  1535.         --------------------------------------------------------------
  1536.  
  1537.         Maybe you remember the good old days. In those days you had to
  1538.         build a menu for every available message and file area. Those
  1539.         days are gone. Now there is menu templating. This means you
  1540.         have one menu for all your message areas, another for all
  1541.         your file areas and another for your doors. How does it work?
  1542.  
  1543.         First you design your menu. Then you enter all the needed
  1544.         information. But instead of entering messagebase numbers, you
  1545.         enter /M. SuperBBS will replace this with a message area
  1546.         number. The same for the file areas. Design your menu, enter
  1547.         the /F instead of the directory. SuperBBS will replace it with
  1548.         the information given in the CONFIG.BBS program. When design-
  1549.         ing your menu for doors, use the /D option, instead of the
  1550.         doorname.
  1551.  
  1552.         Let's have a look at how to setup a message menu this way:
  1553.  
  1554.         First you have to get from your main menu to the message menu.
  1555.         We want to start in area 01. We use menu option 1 and the
  1556.         optional data field would be: MAIL /M. MAIL is the menu
  1557.         name, /M tells SuperBBS to go to the message area last visited
  1558.         by the user. If he/she never visited a the mail areas, he/she
  1559.         will be placed in the first area defined in CONFIG.EXE. If you
  1560.         want to go to the second area, you could also have said /M=2.
  1561.  
  1562.  
  1563.  
  1564.  
  1565.         --------------------------------------------------------------
  1566.         SuperBBS v1.16 - Part B                               Page 125
  1567.  
  1568.  
  1569.         Now we need the read, write, scan, quickscan and delete
  1570.         options. Set up the menu as you normally would, except instead
  1571.         of using the messagebase number, use the /M in the optional
  1572.         data field. SuperBBS will know in what area the user is. Even
  1573.         if the user goes to the main menu and then returns to the
  1574.         messagebase, he/she will still be in the area he/she left
  1575.         from, because SuperBBS keeps track of the users movement.
  1576.  
  1577.         You can use the /M (/F for fileareas and /D for doors) for
  1578.         changing the area. If you use a type 1 menu and as optional
  1579.         data field the menu name and /M=+1, SuperBBS will change to
  1580.         the next area. If you use in the optional data field the
  1581.         /M=-1, SuperBBS will change area to the previous area. This
  1582.         option is endless, because the user is placed back to the
  1583.         first area when he/she wants to go to the next area from the
  1584.         last area. It looks like this:
  1585.  
  1586.               ---> 1 --> 2 --> 3 --> 4 --> 5 --> 6 --> 7 ---
  1587.               |                                            |
  1588.               ----------------------------------------------
  1589.  
  1590.         In this example is area 1 the lowest and area 7 the highest.
  1591.         This also works the other way around.
  1592.  
  1593.         So in short:
  1594.  
  1595.         Menu type  1 - MenuName /M    = Goto message area
  1596.         Menu type  2 - MenuName /F=31 = Gosub file area 31
  1597.         Menu type 23 - /M             = Read messages in current area
  1598.         Menu type 32 - /F             = Download from current area
  1599.         Menu type  1 - MenuName /M=+1 = Goto next message area
  1600.         Menu type  1 - Menuname /F=-1 = Goto previous file area
  1601.         Menu type  1 - MenuName /D    = Goto door menu
  1602.         Menu type  1 - MenuName /D=+1 = Goto next door menu
  1603.         Menu type 86 - /D             = Run current door
  1604.  
  1605.         To show the name and number of the area you are currently in
  1606.         use these codes:
  1607.  
  1608.         <Ctrl-K>4      = File area name in ANS/ASC files
  1609.         <Ctrl-K>5      = Message area name in ANS/ASC files
  1610.         <Ctrl-K>"      = Number of current message template area
  1611.         <Ctrl-K>#      = Number of current file template area
  1612.         <Ctrl-K>&      = Name of current door
  1613.         <Ctrl-K>/      = Number of current door
  1614.         @ (Ascii 64)   = File area name in menu textline
  1615.         ' (Ascii 96)   = Message area name in menu textline
  1616.  
  1617.         These codes are replaced with the name you have set up in the
  1618.         CONFIG.EXE program. If you use characters behind these codes,
  1619.         please think about the fact that the codes will be replaced by
  1620.         the area name, so you might have to check if your menu is
  1621.         still aligned the way you want it.
  1622.  
  1623.         --------------------------------------------------------------
  1624.         SuperBBS v1.16 - Part B                               Page 126
  1625.  
  1626.  
  1627.         Example:
  1628.  
  1629.         In your menu:       Area ^K#: @         SuperBBS HQ
  1630.         For the user:       Area 12: General area         SuperBBS HQ
  1631.  
  1632.         In this example the user is in file area 12, General area.
  1633.         Note that the control code should be entered by holding down
  1634.         the Control key and pressing the K key. The # is a normal
  1635.         character which should be entered without the control key
  1636.         being pressed.
  1637.  
  1638.         SuperBBS saves the template information, so the user will be
  1639.         put in the same template menu he/she was last in when calling
  1640.         the next time.
  1641.  
  1642.         5.4       Changing hardcoded menu options
  1643.         --------------------------------------------------------------
  1644.  
  1645.         SuperBBS has the option to allow the use of your own commands,
  1646.         instead of the hardcoded menus in SuperBBS. These options can
  1647.         be used for these menu commands:
  1648.  
  1649.              23   Read messages
  1650.              24   Scan messages
  1651.              25   Quickscan messages
  1652.  
  1653.         These are the available commands to replace the hardcoded box
  1654.         in SuperBBS. You need to set these options in the optional
  1655.         data field, when editing a menu.
  1656.  
  1657.              /F        Read messages in forward order
  1658.              /R        Read messages in reverse order
  1659.              /I        Read individual messages
  1660.              /N        Read new messages
  1661.              /S        Read selected messages
  1662.              /M        Read marked messages
  1663.              /O        Read n number of messages
  1664.  
  1665.         These options are also available in template menus, so you're
  1666.         able to build a very powerful (and in your own language if
  1667.         needed) message menu. Here is an example of a menu.
  1668.  
  1669.         Menu Opt. data Menu textline
  1670.         ---- --------  ----------------------------------------------
  1671.         23   /M /F     Read messages in forward order in current area
  1672.         24   8 /S      Read selected messages in area 8
  1673.         25   /M /N     Quickscan new messages in current area
  1674.         27   /M        Write a new message in current area
  1675.         68             Choose other area from area list
  1676.  
  1677.         And your imagination can do the rest. It is just an example,
  1678.         so don't use it as a complete menu!
  1679.  
  1680.  
  1681.         --------------------------------------------------------------
  1682.         SuperBBS v1.16 - Part B                               Page 127
  1683.  
  1684.  
  1685.         5.5       INCLUDE1.MNU
  1686.         --------------------------------------------------------------
  1687.  
  1688.         This is a very special menu file. This menu allows up to 10
  1689.         commands to be entered, which then will be added to all your
  1690.         existing menus. If SuperBBS finds this file in your menu
  1691.         directory, all menu commands are available to the user at any
  1692.         menu in your BBS. Very useful for the logoff command, paging
  1693.         the Sysop, help and what you can think of. Design the menu as
  1694.         you normally would design a menu.
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.         --------------------------------------------------------------
  1740.         SuperBBS v1.16 - Part B                               Page 128
  1741.  
  1742.  
  1743.         Chapter 6      Control codes
  1744.         ==============================================================
  1745.  
  1746.         6.1       Control codes in menu and textfiles
  1747.         --------------------------------------------------------------
  1748.  
  1749.         You can now use several control codes in your menu. They don't
  1750.         have to be displayed through an ANSI or ASCII file, but can be
  1751.         used on the menu textline itself.
  1752.  
  1753.         Here's a complete list of all the control codes you can use,
  1754.         either in an ANSI or ASCII file or in your menu textline:
  1755.         (^ = Ctrl key)
  1756.  
  1757.         ASCII     Char.     Function description
  1758.         --------- --------  -----------------------------------------
  1759.          1        ^A        Wait for ENTER key to be pressed
  1760.          2        ^B        Turns OFF aborting with S key
  1761.          3        ^C        Turns ON aborting with S key
  1762.          4        ^D        Turns ON the 'More' prompt
  1763.          5        ^E        Turns OFF the 'More' prompt
  1764.          6        ^F        Not used alone (See below)
  1765.          7        ^G        Generates a 'BEEP'
  1766.          8        ^H        Backspace
  1767.          9        ^I        Tabulator
  1768.         10        ^J        Linefeed
  1769.         11        ^K        Not used alone (See below)
  1770.         12        ^L        Clears screen
  1771.         13        ^M        Carriage return
  1772.  
  1773.         6.2       ^F codes
  1774.         --------------------------------------------------------------
  1775.  
  1776.         The ^F codes available: (All codes apply to current user!)
  1777.  
  1778.         ASCII     Char.     Function description
  1779.         --------- --------  -----------------------------------------
  1780.         6 65      ^FA       User's full name
  1781.         6 66      ^FB       User's city and state
  1782.         6 67      ^FC       User's password (Use with care!)
  1783.         6 68      ^FD       User's business/data phone number
  1784.         6 69      ^FE       User's home/voice phone number
  1785.         6 70      ^FF       User's last calling date
  1786.         6 71      ^FG       User's last calling time (24 hrs format)
  1787.         6 72      ^FH       User's A flagsetting
  1788.         6 73      ^FI       User's B flagsetting
  1789.         6 74      ^FJ       User's C flagsetting
  1790.         6 75      ^FK       User's D flagsetting
  1791.         6 76      ^FL       User's netmail credit
  1792.         6 77      ^FM       Number of messages user has written
  1793.         6 78      ^FN       Highest message number user has read
  1794.  
  1795.         (Continued on next page)
  1796.  
  1797.         --------------------------------------------------------------
  1798.         SuperBBS v1.16 - Part B                               Page 129
  1799.  
  1800.  
  1801.         6 79      ^FO       User's security level
  1802.         6 80      ^FP       User's number of calls
  1803.         6 81      ^FQ       User's uploads in files
  1804.         6 82      ^FR       User's uploads in KBytes
  1805.         6 83      ^FS       User's downloads in files
  1806.         6 84      ^FT       User's downloads in KBytes
  1807.         6 85      ^FU       Elapsed time this call in minutes
  1808.         6 86      ^FV       User's screen length
  1809.         6 87      ^FW       User's firstname
  1810.         6 88      ^FX       Status ANSI graphics (ON/OFF)
  1811.         6 89      ^FY       Status More prompt (ON/OFF)
  1812.         6 90      ^FZ       Status CLS codes (ON/OFF)
  1813.         6 48      ^F0       User's Sysop comment
  1814.         6 49      ^F1       Status Full Screen editor (ON/OFF)
  1815.         6 50      ^F2       User's age
  1816.         6 51      ^F3       User's birthday
  1817.         6 52      ^F4       User's time of first call (24 hrs format)
  1818.         6 53      ^F5       User's date of first call
  1819.         6 54      ^F6       Status of mailcheck at logon (ON/OFF)
  1820.         6 55      ^F7       User's up/download ratio in KBytes
  1821.         6 56      ^F8       User's up/download ratio in files
  1822.         6 57      ^F9       Status new files check at logon (ON/OFF)
  1823.         6 33      ^F!       Total minutes used
  1824.         6 34      ^F"       Status full screen reader
  1825.         6 35      ^F#       Expiration date
  1826.         6 36      ^F$       Expiration days left
  1827.         6 37      ^F%       Status of combined mail check
  1828.         6 38      ^F&       User's default protocol
  1829.         6 47      ^F/       Status of Hotkeys (ON/OFF)
  1830.  
  1831.         6.3       ^K codes
  1832.         --------------------------------------------------------------
  1833.  
  1834.         The ^K codes available:
  1835.  
  1836.         ASCII     Char.     Function description
  1837.         --------- --------  -----------------------------------------
  1838.         11 65     ^KA       Total number of calls to system
  1839.         11 66     ^KB       Name of the last caller
  1840.         11 67     ^KC       Number of active messages on system
  1841.         11 68     ^KD       Number of lowest message on system
  1842.         11 69     ^KE       Number of highest message on system
  1843.         11 70     ^KF       Number of times user has yelled SysOp
  1844.         11 71     ^KG       Day of the week in full
  1845.         11 72     ^KH       Number of users on system
  1846.         11 73     ^KI       Current time (24 hrs format)
  1847.         11 74     ^KJ       Current date (DD-MM-YY)
  1848.         11 75     ^KK       Number of minutes connected this call
  1849.         11 76     ^KL       Number of seconds connected this call
  1850.         11 77     ^KM       Number of minutes used against time limit
  1851.         11 78     ^KN       Number of seconds used against time limit
  1852.  
  1853.         (Continued on next page)
  1854.  
  1855.         --------------------------------------------------------------
  1856.         SuperBBS v1.16 - Part B                               Page 130
  1857.  
  1858.  
  1859.         11 79     ^KO       Number of minutes remaining this call
  1860.         11 80     ^KP       Number of seconds remaining this call
  1861.         11 81     ^KQ       Time Limit this call (Minutes)
  1862.         11 82     ^KR       User's baud rate (300-38400)
  1863.         11 83     ^KS       Abbreviated day of week
  1864.         11 84     ^KT       Download Limit in KBytes
  1865.         11 85     ^KU       Number of minutes until next system event
  1866.         11 86     ^KV       Time of next system event (24 hrs format)
  1867.         11 89     ^KY       User's maximum up/download ratio in KBytes
  1868.         11 90     ^KZ       User's maximum up/download ratio in files
  1869.         11 48     ^K0       Current language file description
  1870.         11 49     ^K1       Status of scroll lock
  1871.         11 50     ^K2       One second pause
  1872.         11 51     ^K3       Display securitylevel comment (LIMITS.BBS)
  1873.         11 52     ^K4       Name of the current filearea
  1874.         11 53     ^K5       Name of the current message area
  1875.         11 54     ^K6       User's alias
  1876.         11 55     ^K7       User's time in bank
  1877.         11 56     ^K8       User's number of calls today
  1878.         11 57     ^K9       Number of messages in current area
  1879.         11 33     ^K!       Status of do not disturb flag (ON/OFF)
  1880.         11 46     ^K.       Number of current node
  1881.         11 34     ^K"       Number of current message template area
  1882.         11 35     ^K#       Number of current file template area
  1883.         11 37     ^K%       User's download remaining today in KBytes
  1884.         11 38     ^K&       Name of the current door
  1885.         11 47     ^K/       Number of the current door
  1886.  
  1887.         Do not use the ^Q, ^S and ^Z commands, because these are
  1888.         dangerous and can give you unexpected problems. To enter a
  1889.         code in your textfiles, use the Ctrl-F command. This means,
  1890.         press the control key, hold down while pressing the mentioned
  1891.         key (in this example the F), release and press the second
  1892.         character (in case of the ^F and ^K keys.) Another way is
  1893.         holding down the ALT key and pressing the ASCII value from the
  1894.         numeric keypad on the right of the keyboard. This only works
  1895.         on EXTENDED keyboards!!
  1896.  
  1897.         6.4       ^X, ^C, ^P and ^A keys
  1898.         --------------------------------------------------------------
  1899.  
  1900.         There are four special control keys available. These have
  1901.         special functions in SuperBBS or the external utilities.
  1902.  
  1903.         The ^X key is used to run a program from an ANSI or ASCII
  1904.         file. If superBBS comes across an ^X code while displaying a
  1905.         file, it will execute the program behind the ^X code. For an
  1906.         example:
  1907.  
  1908.              ^XMYPROG.EXE
  1909.  
  1910.         This will start the MYPROG.EXE program when the file is dis-
  1911.         played where this code is in.
  1912.  
  1913.         --------------------------------------------------------------
  1914.         SuperBBS v1.16 - Part B                               Page 131
  1915.  
  1916.  
  1917.         The ^C, ^P and ^A key are used in the LCONFIG program and menu
  1918.         editor. The ^C code is used for changing colour in the text-
  1919.         lines in LCONFIG.EXE. (See the language configuration part of
  1920.         the docs for more info.) The ^A executes a display of a file
  1921.         in the language files. You can use this command to display an
  1922.         ANSI/ASCII file, instead of the normal textline. ^AHELP will
  1923.         display the file HELP.A?? from the textfile directory.
  1924.  
  1925.         The ^P key is used to enter another control code in the menu
  1926.         and/or textlines. You have to press ^P first, before you can
  1927.         enter a control code in a textline or menuline.
  1928.  
  1929.         6.5       ^O control codes
  1930.         --------------------------------------------------------------
  1931.  
  1932.         With the release of the 1.15 version of SuperBBS, a new set of
  1933.         control codes have been added to the program. These codes are
  1934.         accessed through the ^O key. You can use the ^O key to display
  1935.         the flagsettings of the user. Here's the commandline:
  1936.  
  1937.              ^O<Flag><Flag number>
  1938.  
  1939.         This will display the current user's flagsetting, either On or
  1940.         Off. For example ^OA5 will display the setting of flag A,
  1941.         number 5. With this option you can display all 32 flags.
  1942.  
  1943.         6.6       Additional control codes
  1944.         --------------------------------------------------------------
  1945.  
  1946.         Some additional control keys can be used within the message-
  1947.         base from SuperBBS. These codes are:
  1948.  
  1949.              @1   User's name
  1950.              @2   User's City & State
  1951.              @3   User's security level
  1952.              @4   User's birthday
  1953.              @5   User's age
  1954.              @6   User's firstname
  1955.  
  1956.         These codes can be used, if you did allow them to be used in
  1957.         CONFIG.EXE, in messages written in SuperBBS.
  1958.  
  1959.         The following additional control keys are needed for setting
  1960.         up a multiline system with template menus. These codes can be
  1961.         used in the data fields of the menus. The codes are:
  1962.  
  1963.              @N   Number of the node the user is on
  1964.              @M   Number of current message template area
  1965.              @F   Number of current file template area
  1966.              @G   Character of current message area group
  1967.              @S   User's security level
  1968.              @D   Number of the current template door
  1969.  
  1970.  
  1971.         --------------------------------------------------------------
  1972.         SuperBBS v1.16 - Part B                               Page 132
  1973.  
  1974.  
  1975.         These codes allow you to use the temporarily areas in a multi-
  1976.         line system. For example, name your temporarily directories
  1977.         TEMP1 and TEMP2, for line 1 and 2, and specify the optional
  1978.         data field with TEMP@N, which will be replaced by TEMP1 or
  1979.         TEMP2 depending on the node the user is on.
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.         --------------------------------------------------------------
  2030.         SuperBBS v1.16 - Part B                               Page 133
  2031.  
  2032.  
  2033.         Chapter 7.     Message base
  2034.         ==============================================================
  2035.  
  2036.         7.1       General information
  2037.         --------------------------------------------------------------
  2038.  
  2039.         The SuperBBS message base is fully compatible with QuickBBS
  2040.         and RemoteAccess. This will not guarantee that this will stay
  2041.         this way in the future. Either SuperBBS or the other programs
  2042.         might come up with a better type of message base. Currently
  2043.         you can use your old messagebase when converting from RA and
  2044.         QuickBBS to SuperBBS. You should set up the location of your
  2045.         messagebase in the CONFIG.EXE program.
  2046.  
  2047.         User's (and Sysop) are able to read, write, scan, quickscan
  2048.         and delete messages. The messages are numbered in increasing
  2049.         order. The first message starts at one, the second at two and
  2050.         so on. This doesn't mean both messages are in the same area.
  2051.         Besides the message number, SuperBBS also keeps track in which
  2052.         area the message belongs. When reading messages, you will see
  2053.         a notice stating that there are xxxx messages active. And that
  2054.         the lowest message is numbered yyyy and the highest zzzz. Also
  2055.         stated is the amount of messages in the current area. It looks
  2056.         something like this:
  2057.  
  2058.         Active msgs: 1234. Lowest message: 1. Highest message: 23460
  2059.         Number of messages in this area: 25.
  2060.  
  2061.         This means that from the 1234 messages, which starts at 1 and
  2062.         ends at 23460, there are 25 messages in the current area.
  2063.  
  2064.         SuperBBS now also supports real message numbering in an area.
  2065.         Every message area will be numbered from 1 to xx. This only
  2066.         applies to the user reading mail. Internally SuperBBS still
  2067.         uses the normal message numbering as described above.
  2068.  
  2069.         If you use this option of real message numbering, which we
  2070.         strongly suggest cause it is easier for your users to keep
  2071.         track of numbers while reading messages, you will have to
  2072.         change a line in the language file. This is the line stating
  2073.         the amount of messages in the messagebase. This has to be
  2074.         changed to the amount of messages per area. See the Lconfig
  2075.         part for more information.
  2076.  
  2077.         As of version 1.16, SuperBBS uses a new file to store the
  2078.         message areas in. This file is called BOARDS.BBS. You can have
  2079.         one file for all nodes, or have a file for every node. This
  2080.         way you can allow access to certain areas on certain lines.
  2081.         You can set this option in the configuration program (Path
  2082.         options). There is a little utility program to convert the
  2083.         information from the BOARDS.BBS file to the CONFIG.BBS file,
  2084.         so that external, non SuperBBS, programs can still be used.
  2085.         This utility is called BOARD2CF.EXE.
  2086.  
  2087.         --------------------------------------------------------------
  2088.         SuperBBS v1.16 - Part B                               Page 134
  2089.  
  2090.  
  2091.         Please take a moment to look at the new options in the mes-
  2092.         sagebase configuration menu. New options are:
  2093.  
  2094.              - Longer names for the message areas
  2095.              - Separate QWK area name
  2096.              - Minimum age to access area
  2097.              - Message group support
  2098.              - Tagline allowance per area
  2099.  
  2100.         More options have been added to the message base configur-
  2101.         ation.
  2102.  
  2103.         7.2       Sysop keys available
  2104.         --------------------------------------------------------------
  2105.  
  2106.         The following options are available to the Sysop when reading
  2107.         messages:
  2108.  
  2109.         <A>gain             Show current message again.
  2110.         <N>ext              Show next message
  2111.         <B>ack              Show previous message
  2112.         <J>ump              Jump to specified message
  2113.         <R>eply             Reply to the current message
  2114.         <W>rite             Write a message in current area
  2115.         <D>elete            Remove the current message
  2116.         <K>eep as unread    Toggle the read/unread flag on/off
  2117.         <X>port             Send message to printer or file
  2118.         <C>opy              Copy current message to another user/board
  2119.         <E>dit              Edit the message information, like:
  2120.                             1. From        Who wrote the message
  2121.                             2. To          To whom message is send
  2122.                             3. Subject     Subject of the message
  2123.                             4. Board       Area number where msg is
  2124.                             5. Quit        Abort editing
  2125.                             6. Save        Save message
  2126.         <=>Private          Toggle the private/public flag on/off
  2127.         <S>top              Stop reading messages
  2128.  
  2129.         Use the <E>dit command and option 4 if you want to copy a
  2130.         message to another area. Use the <C>opy command if you want to
  2131.         forward a message to another user or system.
  2132.  
  2133.         One undocumented option is available to Sysops when reading
  2134.         ECHO and NET mail, the <!>. This allows you to see the infor-
  2135.         mation normally hidden in a message through a Ctrl-A code.
  2136.         Information like path and kludges are normally hidden behind
  2137.         these codes.
  2138.  
  2139.         Please note that these commands may differ from language to
  2140.         language, because you can change them in the LCONFIG.EXE
  2141.         program.
  2142.  
  2143.  
  2144.  
  2145.         --------------------------------------------------------------
  2146.         SuperBBS v1.16 - Part B                               Page 135
  2147.  
  2148.  
  2149.         7.3       QWK offline mail system
  2150.         --------------------------------------------------------------
  2151.  
  2152.         SuperBBS is one of the first bulletin boards to support QWK
  2153.         packets directly. QWK is a mailreader system. this means the
  2154.         user downloads the messages and instead of reading them on-
  2155.         line, he/she can read them offline, saving a lot of money.
  2156.         Here's how it works.
  2157.  
  2158.         A user calls in on your board. he/she goes to the QWK menu
  2159.         options and selects the download command (menu option 82).
  2160.         First SuperBBS will ask the user if he/she wants to download
  2161.         the messages in QWK or ASCII format. (Most will choose QWK,
  2162.         sine it makes smaller packets.) Than SuperBBS will scan
  2163.         through the message areas for any unread mail in the areas the
  2164.         user selected. If there is new mail, SuperBBS will export the
  2165.         messages and put them in an archive. This user can download
  2166.         this archive. Offline, the user goes into the mail reader, for
  2167.         example the Silly Little Mail Reader (TM) or the XRS reader
  2168.         (TM), which now also supports the QWK packets. He/she than
  2169.         reads the messages, write replies or/and new messages and on
  2170.         the next call uploads these messages with the upload command
  2171.         (menu option 83).
  2172.  
  2173.         Besides the mail package, your WELCOME.A?? and GOODBYE.A?? are
  2174.         packed in the archive. The same accounts for your NEWS.A??
  2175.         file, if available. These will be displayed while reading the
  2176.         messages with the SLMR program.
  2177.  
  2178.         SuperBBS will place the QWK packets in the WORK directory, as
  2179.         specified in your path settings in the configuration menu.
  2180.         Packets are deleted after the user has downloaded them.
  2181.  
  2182.         To separate your packets from those from other Bulletin board
  2183.         systems, you have to give the QWK packet an unique name. (Also
  2184.         done in the configuration program.) The reply packets will
  2185.         have the same name, except for the extension, which will be
  2186.         .REP, instead of the .QWK for the mailpacket.
  2187.  
  2188.         With menu option 84 is the user able to select where SuperBBS
  2189.         will start searching for new messages. This menu option allows
  2190.         to change the lastreadpointer of the user.
  2191.  
  2192.         Taglines can be allowed on your system. A tagline is a little
  2193.         line below the message with a witty or funny textline. Not all
  2194.         echomail areas allow the use of the tagline, because echomail
  2195.         already adds an origin line to the message, giving it a double
  2196.         originline, when a tagline is also added. You can select to
  2197.         use or not use taglines in the messagebase configuration menu
  2198.         per area.
  2199.  
  2200.  
  2201.  
  2202.  
  2203.         --------------------------------------------------------------
  2204.         SuperBBS v1.16 - Part B                               Page 136
  2205.  
  2206.  
  2207.         Selecting the areas you want the mail from is done through the
  2208.         use of the area select command for message area 0, the global
  2209.         message area. (Menu option 28.) Areas which are set to On will
  2210.         be used to export the mail from. Areas set to Off will not be
  2211.         scanned for mail. It is useful to put this menu option in your
  2212.         QWK menu screen.
  2213.  
  2214.         Since SuperBBS now allows longer names for the areas, a
  2215.         special short QWK name option has been added to the configur-
  2216.         ation of the messagebase.
  2217.  
  2218.         QWK support is not 100% yet in this version of SuperBBS, but
  2219.         it will be in the near future. It is however ready enough to
  2220.         be used by your users.
  2221.  
  2222.         Support the offline mail reader and get your users to use it.
  2223.  
  2224.         7.4       Group messages
  2225.         --------------------------------------------------------------
  2226.  
  2227.         A very powerful way to send a message to every user or just a
  2228.         certain security level is the Group message function. If
  2229.         enabled, every user who logs on to your system will get the
  2230.         message as if it is addressed to him/her personally.
  2231.  
  2232.         You have to address the message to: *everyone*. In this case
  2233.         everybody will receive the message. If posted to a certain
  2234.         security number, like *everyone*100, only users with security
  2235.         level 100 will receive the message.
  2236.  
  2237.         Post a group message always as a private message, otherwise
  2238.         all users can read the message.
  2239.  
  2240.         There are two new options available with menu option 22 (mail
  2241.         check), these options are:
  2242.  
  2243.              /A        Display all messages (New normal messages and
  2244.                        new group messages).
  2245.              /G        Display only new group messages.
  2246.  
  2247.         This message system could be used for informing your users
  2248.         about certain things happening on your BBS or any other infor-
  2249.         mation. You will have to set the security level needed to post
  2250.         group messages in the configuration program. This means you
  2251.         can also let your users send group messages.
  2252.  
  2253.         7.5       Netmail
  2254.         --------------------------------------------------------------
  2255.  
  2256.         SuperBBS is a fidonet compatible BBS program. This means you
  2257.         can exchange messages with other systems. These messages can
  2258.         be NETMAIL or ECHOMAIL.
  2259.  
  2260.  
  2261.         --------------------------------------------------------------
  2262.         SuperBBS v1.16 - Part B                               Page 137
  2263.  
  2264.  
  2265.         SuperBBS does use a nodelist, but you will still need a mailer
  2266.         who will handle the sending of the netmail, for example Front-
  2267.         door (TM), Intermail (TM) or D'Bridge (TM).
  2268.  
  2269.         If you have setup a netmail directory, SuperBBS will ask you
  2270.         for the address the message has to be send to. Here you have
  2271.         to enter a valid fidonet address. If you don't know the
  2272.         address, you can browse through the nodelist and search for
  2273.         the node you want. If your replying to a message, SuperBBS
  2274.         will try to match the senders zone, if you have an AKA in the
  2275.         senders network. If SuperBBS can't match the senders zone, he
  2276.         will use the main address. After you supplied the destination
  2277.         address, SuperBBS will ask you if the message is a CRASH (or
  2278.         send immediately) message. Third and last question is about
  2279.         File attachments. You can send a file to another BBS this way.
  2280.         If you say YES to the previous question, SuperBBS will ask you
  2281.         for the filename. Then you can enter your message. Contact a
  2282.         BBS system running Netmail if you want more information on
  2283.         this subject. See the external utilities for more info on the
  2284.         SBBSNODE.EXE program.
  2285.  
  2286.         SuperBBS now also supports Point addresses, even if there is
  2287.         no nodelist available.
  2288.  
  2289.         7.6       Echomail
  2290.         --------------------------------------------------------------
  2291.  
  2292.         Echomail is mail that is distributed every night over several
  2293.         BBS systems. This means your message could get all over the
  2294.         world, depending on the area your in. This also is the most
  2295.         expensive form of mail. A message written on your system can
  2296.         be read on hundreds of other systems. All messages are always
  2297.         public.
  2298.  
  2299.         You can setup every message area in SuperBBS for echomail use.
  2300.         You can select a different AKA address (if you have them) and
  2301.         choose an origin line for every area (through ECHOORIG.CTL).
  2302.         You will need a front end program (also called mailer) to run
  2303.         Echomail.
  2304.  
  2305.         To run echomail you need an echomail processor. These will
  2306.         unpack messages from the archives they are send in and toss
  2307.         them to your echomail area. They also pack new messages from
  2308.         your system and prepare them to be transferred.
  2309.  
  2310.         Some processors are:
  2311.  
  2312.              - ZmailH       Echo & Netmail scanner/tosser
  2313.              - TosScan      Echo & Netmail scanner/tosser
  2314.              - Imail        Echo & Netmail scanner/tosser
  2315.              - GEcho        Echomail processor
  2316.  
  2317.  
  2318.  
  2319.         --------------------------------------------------------------
  2320.         SuperBBS v1.16 - Part B                               Page 138
  2321.  
  2322.  
  2323.         There are more programs available. Ask for them at a BBS near
  2324.         you, running echomail. The D'Bridge mailer has net and echo-
  2325.         mail support build into the program and support SuperBBS.
  2326.  
  2327.         You will also need some echomail utility program. This program
  2328.         must be capable of linking messages, renumbering and deleting
  2329.         them. One of the best programs around is MBUTIL (TM) written
  2330.         by Gerard van der Land. This program can take care of all your
  2331.         echomail area maintenance and more.
  2332.  
  2333.         7.7       Nodelist support
  2334.         --------------------------------------------------------------
  2335.  
  2336.         SuperBBS has a limited Nodelist support build in. Limited
  2337.         because the cost support is not yet available. SuperBBS uses
  2338.         the QuickBBS alike indexfiles. These are created with the
  2339.         SBBSNODE.EXE program. Their is a menu option available to
  2340.         browse through the nodelist. When entering echomail, you have
  2341.         the option to scan through the nodelist to find the address.
  2342.         SuperBBS support point addresses.
  2343.  
  2344.         If no nodelist is available, SuperBBS will still work and you
  2345.         can still sent netmail. Also point addresses are still sup-
  2346.         ported.
  2347.  
  2348.         7.8       Search userlist
  2349.         --------------------------------------------------------------
  2350.  
  2351.         When enabled in the configuration program, SuperBBS allows the
  2352.         user who entered a non-existing name in a local message area
  2353.         to scan through the userlist. You can toggle this function on
  2354.         and off in the configuration program.
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.         --------------------------------------------------------------
  2378.         SuperBBS v1.16 - Part B                               Page 139
  2379.  
  2380.  
  2381.         Chapter 8.     Files base
  2382.         ==============================================================
  2383.  
  2384.         8.1       General information
  2385.         --------------------------------------------------------------
  2386.  
  2387.         The filebase is just like SuperBBS messagebase compatible with
  2388.         RemoteAccess and QuickBBS. SuperBBS uses a FILES.BBS file to
  2389.         display the available files to the users. This file looks like
  2390.         this when viewed with a normal ASCII editor:
  2391.  
  2392.         Filename     Description
  2393.  
  2394.                      ^---- Cursor position 14
  2395.  
  2396.         SuperBBS will add the information like size and date if the
  2397.         file is found in the current area. If not, the word defined in
  2398.         the lconfig program for the word offline will be displayed
  2399.         instead of the date and size. The description has to start on
  2400.         character number 14. SuperBBS allows you to have more then one
  2401.         file description line. You can set this information in the
  2402.         CONFIG.EXE program. If you want to add a line with a text
  2403.         editor, use one who ends without putting a Ctrl-Z at the end
  2404.         of the document, start the extra description line with the
  2405.         ' >'(ASCII 32+62) sign. This will tell SuperBBS it is a file
  2406.         description line and will display it at the right place. (See
  2407.         the example in the part of this chapter concerning the up-
  2408.         loader name.)
  2409.  
  2410.         SuperBBS now also wraps the text around if the textline is
  2411.         longer than 45 characters. The wrapped text will be displayed
  2412.         at the right indent. You can set this in the configuration
  2413.         program.
  2414.  
  2415.         8.2       Extract and view option
  2416.         --------------------------------------------------------------
  2417.  
  2418.         SuperBBS allows you and your users to extract, view and repack
  2419.         a file while on-line. SuperBBS has support for ZIP, LZH, PAK,
  2420.         ARJ and ARC files. You can extract a file, view the contents
  2421.         of the file, read textfiles from within the file and repack
  2422.         only the wanted files, while discarding the rest. SuperBBS
  2423.         makes use for this option of the TEMP directory which you have
  2424.         to set up in CONFIG.EXE.
  2425.  
  2426.         After use, SuperBBS will clean the area in case the user
  2427.         doesn't and if you have set the option on in CONFIG.EXE.
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.         --------------------------------------------------------------
  2436.         SuperBBS v1.16 - Part B                               Page 140
  2437.  
  2438.  
  2439.         8.3       Uploader to files.bbs
  2440.         --------------------------------------------------------------
  2441.  
  2442.         SuperBBS allows you to optional put the username of the upload
  2443.         in the files list. This only works if you have the use of the
  2444.         '>' character in the files base listing set to on. SuperBBS
  2445.         will put the name of the uploader as the last line of the
  2446.         description. It will look like this:
  2447.  
  2448.         SBBS_115.ZIP  532267  15-jan-91  New SuperBBS release v1.15
  2449.                                          Full featured version.
  2450.                                          Uploader: Aki Antman
  2451.  
  2452.         This is what your users will see. In your files.bbs list it
  2453.         will look something like this:
  2454.  
  2455.         SBBS_115.ZIP  New SuperBBS release v1.15
  2456.          >Full featured version.
  2457.          >Uploader: Aki Antman
  2458.  
  2459.         Some Sysops use this method to give you some more system
  2460.         security, because everybody can see which file is uploaded by
  2461.         whom, preventing them to send you trojanhorses or virusfiles.
  2462.  
  2463.         8.4       FILES.CTL
  2464.         --------------------------------------------------------------
  2465.  
  2466.         This file, which is a plain ASCII file, gives you control over
  2467.         the files in your filebase. It is possible to assign passwords
  2468.         to files, specify unwanted files and allow free files. Use
  2469.         this file as follows:
  2470.  
  2471.                        <Filename>     /FREE
  2472.                        <Filename>     /UNWANTED
  2473.                        <Filename>     /PWD=<password>
  2474.  
  2475.         You can use wildcards in the filenames. If you don't specify a
  2476.         directory, the option will work in all file areas. Here's an
  2477.         example:
  2478.  
  2479.                        SBBS_111.ZIP   /FREE
  2480.                        BETA_112.ZIP   /PWD=BETATEST /FREE
  2481.                        *.GIF          /UNWANTED
  2482.                        C:\TMP\ZIP.ZIP /FREE
  2483.  
  2484.         This will make the SBBS file free, protect the free file Beta
  2485.         with a password, tells users .GIF files are not welcome and
  2486.         makes the ZIP.ZIP in the TMP directory also free.
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.         --------------------------------------------------------------
  2494.         SuperBBS v1.16 - Part B                               Page 141
  2495.  
  2496.  
  2497.         8.5       File flagging & Archive view
  2498.         --------------------------------------------------------------
  2499.  
  2500.         SuperBBS has file flagging build into the program. File flag-
  2501.         ging means you can select a file which you want to download,
  2502.         while viewing the newfiles list or normal file list. This
  2503.         command is part of the more prompt, which is shown when the
  2504.         screenlength is reached, or the end of the file is reached.
  2505.         You can select the key to use for this option in the language
  2506.         files by using LCONFIG.EXE. The user only has to select the
  2507.         commandkey and SuperBBS will ask which file to flag. Also
  2508.         available is a menu option, menu type 95, with two options to
  2509.         display the flagged files list and to delete files from the
  2510.         list. See the menu commands for more information.
  2511.  
  2512.         When a user selects the download command, SuperBBS will check
  2513.         if the user flagged files and will ask the user if he/she
  2514.         wants to download these flagged files.
  2515.  
  2516.         A user can never flag more files than his/her downloadlimit
  2517.         would allow. SuperBBS will give a warning if the user wants to
  2518.         flag a file which would exceed the limit.
  2519.  
  2520.         Also available in the more prompt line is the option to peek
  2521.         inside an archive. This is no extract command, it will just
  2522.         show the contents of the specified archive. SuperBBS will ask
  2523.         the user which file to show.
  2524.  
  2525.         Please note that both options use full filenames, no wildcards
  2526.         are allowed here.
  2527.  
  2528.         8.6       Download counter
  2529.         --------------------------------------------------------------
  2530.  
  2531.         SuperBBS has a build in download counter. This allows you to
  2532.         keep track of the number of downloads for each file. In the
  2533.         configuration program you will have to specify which charac-
  2534.         ters you want to use as brackets. (For example: [], () or <>)
  2535.         SuperBBS will keep track of the downloads and everytime a file
  2536.         is downloaded will update the counter. If no counter is avail-
  2537.         able, SuperBBS will add one. This makes your files.bbs file
  2538.         look like this (Using [] as brackets):
  2539.  
  2540.         SBBS_115.ZIP  532267  15-jan-91  [17] SuperBBS version 1.15
  2541.                                          Full featured version
  2542.                                          Uploader: Aki Antman
  2543.         SDOC_115.ZIP  100001  15-jan-91  [2] SuperBBS documentation
  2544.                                          Uploader: Frank Hemmelder
  2545.         SUPERNET.A68   32180  15-jan-91  New SuperNet nodelist
  2546.                                          Uploader: Robbert Roos
  2547.  
  2548.  
  2549.  
  2550.  
  2551.         --------------------------------------------------------------
  2552.         SuperBBS v1.16 - Part B                               Page 142
  2553.  
  2554.  
  2555.         Please note that SuperBBS does not currently fill out the
  2556.         counter when below the 10. This might be available in a later
  2557.         version. Also files not downloaded won't have a counter set to
  2558.         zero.
  2559.  
  2560.         When you set the brackets option in the configuration program
  2561.         to spaces, the downloadcounter will be disabled.
  2562.  
  2563.         8.7       Default protocol
  2564.         --------------------------------------------------------------
  2565.  
  2566.         SuperBBS now allows your users to have a default protocol.
  2567.         This means that SuperBBS will not ask the user which protocol
  2568.         to use, but will go straight to the download start, if the
  2569.         user has selected a default protocol.
  2570.  
  2571.         Users can select a default protocol with menu command 97. (See
  2572.         menu commands). There is also an ANSI/ASCII file available to
  2573.         show the available protocols, instead of the normal protocol
  2574.         list. (See support files for more information.)
  2575.  
  2576.         New users can get the question to select a default protocol at
  2577.         their first logon, if enabled. Already existing users should
  2578.         use the menu command (97) to select a default protocol.
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.         --------------------------------------------------------------
  2610.         SuperBBS v1.16 - Part B                               Page 143
  2611.  
  2612.  
  2613.         Chapter 9.     Support files
  2614.         ==============================================================
  2615.  
  2616.         9.1       General information
  2617.         --------------------------------------------------------------
  2618.  
  2619.         SuperBBS uses a whole range of extra ANSI and ASCII support
  2620.         files. You can define these files yourself, or use the build
  2621.         in (English) messages. This way you can personalize your
  2622.         system. If a file is not available, SuperBBS will display a
  2623.         message of it's own, if needed.
  2624.  
  2625.         You can make these ANSI and ASCII files with a program like
  2626.         Thedraw. It even allows you to use animation in your ANSI
  2627.         files. Do remember that users are calling in and that a long
  2628.         screen build up will scare them away, or they switch to ASCII.
  2629.  
  2630.         SuperBBS will first look for the files in the ANSI/ASCII
  2631.         textfile directory specified in the language files, then in
  2632.         the text directory specified in the CONFIG.EXE program and if
  2633.         still no file is found, it will display the message of it's
  2634.         own, which is normally just a textline explaining what is
  2635.         going on.
  2636.  
  2637.         9.2       ANSI and ASCII Support files
  2638.         --------------------------------------------------------------
  2639.  
  2640.         These are the support files:
  2641.  
  2642.         Name.........: 0001 (0102, 0203......2223, 2324)
  2643.         Type.........: ANS/ASC
  2644.         Description..: File to be displayed at logon, between 00:00
  2645.                        and 01:00 hrs. This way you can setup a file
  2646.                        for every hour. 1516.ANS would be displayed
  2647.                        between 15:00 and 16:00 hrs.
  2648.  
  2649.         Name.........: ALIASASK
  2650.         Type.........: ANS/ASC
  2651.         Description..: This file is displayed at logon of a newuser
  2652.                        just before asking the alias he/she wants to
  2653.                        use. This file should contain some information
  2654.                        about the use of an alias on your board.
  2655.  
  2656.         Name.........: ALTNEWS
  2657.         Type.........: ANS/ASC
  2658.         Description..: This file is displayed to IEMSI users who
  2659.                        selected not to view the normal NEWS.A?? file.
  2660.                        This way you can still give them some news
  2661.                        information. This file is not shown to not
  2662.                        IEMSI users.
  2663.  
  2664.  
  2665.  
  2666.  
  2667.         --------------------------------------------------------------
  2668.         SuperBBS v1.16 - Part B                               Page 144
  2669.  
  2670.  
  2671.         Name.........: APHORISM
  2672.         Type.........: ANS/ASC
  2673.         Description..: Shown to the user before the aphorism (menu
  2674.                        option 85) is shown to the user.
  2675.  
  2676.         Name.........: BFAILED
  2677.         Type.........: ANS/ASC
  2678.         Description..: Shown to the user when he/she enters a wrong
  2679.                        birthday at the birthday verification check.
  2680.  
  2681.         Name.........: BIRTHDAY
  2682.         Type.........: ANS/ASC
  2683.         Description..: Shown when a user calls on his/her birthday.
  2684.  
  2685.         Name.........: BVERIFY
  2686.         Type.........: ANS/ASC
  2687.         Description..: Shown to the user when he/she is asked to give
  2688.                        his/her birthday as part of the system security
  2689.                        check.
  2690.  
  2691.         Name.........: DEFPROT
  2692.         Type.........: ANS/ASC
  2693.         Description..: Shown to the user instead of the normal build
  2694.                        in protocol list when the user has to select a
  2695.                        default protocol.
  2696.  
  2697.         Name.........: DNLDHRS
  2698.         Type.........: ANS/ASC
  2699.         Description..: Shown to a user who wants to download when
  2700.                        downloading is not allowed as specified in
  2701.                        CONFIG.EXE.
  2702.  
  2703.         Name.........: DPHONE
  2704.         Type.........: ANS/ASC
  2705.         Description..: Shown to the user when he/she enters a dupe
  2706.                        phonenumber and the configuration has been set
  2707.                        to disconnect the user after showing this file.
  2708.  
  2709.         Name.........: EDITHELP
  2710.         Type.........: ANS/ASC
  2711.         Description..: Shown to the user when he/she asks for help
  2712.                        within the message editor.
  2713.  
  2714.         Name.........: FGOODBYE
  2715.         Type.........: ANS/ASC
  2716.         Description..: Shown to the user when he/she decided to logoff
  2717.                        after a file transfer. Do not use the code
  2718.                        Ctrl-A (= Press return) in this screen, other-
  2719.                        wise the user can't use the automatic logoff,
  2720.                        because SuperBBS will wait for the return.
  2721.  
  2722.  
  2723.  
  2724.  
  2725.         --------------------------------------------------------------
  2726.         SuperBBS v1.16 - Part B                               Page 145
  2727.  
  2728.  
  2729.         Name.........: GOODBYE
  2730.         Type.........: ANS/ASC
  2731.         Description..: Shown to the user at logoff, just before the
  2732.                        modems disconnect.
  2733.  
  2734.         Name.........: LOGO
  2735.         Type.........: ANS/ASC
  2736.         Description..: Shown to the user before asking the user's name
  2737.                        at logon to your system. At this moment is
  2738.                        SuperBBS not aware which language a user is
  2739.                        using, so it uses the directory specified in
  2740.                        the first language file in LANGUAGE.CTL. If you
  2741.                        are using different languages, this file should
  2742.                        contain all available languages.
  2743.  
  2744.         Name.........: LOGONAGE
  2745.         Type.........: ANS/ASC
  2746.         Description..: Shown to the user when he/she is too young to
  2747.                        logon to your system, as set in the configur-
  2748.                        ation program.
  2749.  
  2750.         Name.........: LOGONFLA
  2751.         Type.........: ANS/ASC
  2752.         Description..: Shown to the user when he/she doesn't have the
  2753.                        correct flagsettings for login in on your sys-
  2754.                        tem, as specified in the configuration program.
  2755.  
  2756.         Name.........: LOGONPWD
  2757.         Type.........: ANS/ASC
  2758.         Description..: Shown to the user when he/she gives the wrong
  2759.                        password for logging on to your system, when
  2760.                        you have specified a global password in the
  2761.                        configuration program.
  2762.  
  2763.         Name.........: LOGONSEC
  2764.         Type.........: ANS/ASC
  2765.         Description..: Shown to the user when his/her security level
  2766.                        is not high enough to logon to your system, as
  2767.                        specified in the configuration program.
  2768.  
  2769.         Name.........: MAXPAGE
  2770.         Type.........: ANS/ASC
  2771.         Description..: Shown to the user when trying to page the Sysop
  2772.                        more times then specified in CONFIG.EXE.
  2773.  
  2774.         Name.........: MSGAREA
  2775.         Type.........: ANS/ASC
  2776.         Description..: Shown to the user at menu type 68, instead of
  2777.                        the normal build in area list.
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.         --------------------------------------------------------------
  2784.         SuperBBS v1.16 - Part B                               Page 146
  2785.  
  2786.  
  2787.         Name.........: NEWS
  2788.         Type.........: ANS/ASC
  2789.         Description..: File displayed to every user at logon. Useful
  2790.                        for newsflashes. Programs like SXNEWS are
  2791.                        easy for creating and editing this file. When a
  2792.                        user uses IEMSI to login, he/she can select to
  2793.                        not view this file. (See also the ALTNEWS
  2794.                        file.) SuperBBS now allows you to select if you
  2795.                        want this file to be shown to the user every
  2796.                        time somebody logs on, or just when it is
  2797.                        updated. SuperBBS will remember the date the
  2798.                        user last read the file and will show the news
  2799.                        file only if the date of the file is newer.
  2800.  
  2801.         Name.........: NEWS1
  2802.         Type.........: ANS/ASC
  2803.         Description..: File shown directly after the NEWS.A?? file.
  2804.  
  2805.         Name.........: NEWUSER1
  2806.         Type.........: ANS/ASC
  2807.         Description..: Shown to newusers after he/she has verified
  2808.                        his/her name and before the other logon ques-
  2809.                        tions are asked. At this point does SuperBBS
  2810.                        not know which language the user wants to use,
  2811.                        so you should make this file contain all avail-
  2812.                        able languages.
  2813.  
  2814.         Name.........: NEWUSER2
  2815.         Type.........: ANS/ASC
  2816.         Description..: File displayed to a new user after he/she
  2817.                        answered the questions about system options and
  2818.                        selected a password, but before the NEWUSER.Q-A
  2819.                        questionnaire is answered.
  2820.  
  2821.         Name.........: NO300
  2822.         Type.........: ANS/ASC
  2823.         Description..: Shown to the user trying to logon to your BBS
  2824.                        at 300 Baud when this is not allowed as you
  2825.                        specified in the CONFIG.EXE file.
  2826.  
  2827.         Name.........: NOCHAT
  2828.         Type.........: ANS/ASC
  2829.         Description..: Shown to the user when his/her name is found in
  2830.                        the NOCHAT.CTL control file and the user tries
  2831.                        to use this option.
  2832.  
  2833.         Name.........: NOPAGE
  2834.         Type.........: ANS/ASC
  2835.         Description..: Shown to the user when you are paged, but you
  2836.                        disabled yell with the Scroll-lock key.
  2837.  
  2838.  
  2839.  
  2840.  
  2841.         --------------------------------------------------------------
  2842.         SuperBBS v1.16 - Part B                               Page 147
  2843.  
  2844.  
  2845.         Name.........: NOREMOTE
  2846.         Type.........: ANS/ASC
  2847.         Description..: Shown to the user when remote Sysops logins are
  2848.                        disabled and somebody tries to get in with your
  2849.                        name.
  2850.  
  2851.         Name.........: NOTAVAIL
  2852.         Type.........: ANS/ASC
  2853.         Description..: Shown to the user when you are paged outside
  2854.                        yelling hours.
  2855.  
  2856.         Name.........: NOTFOUND
  2857.         Type.........: ANS/ASC
  2858.         Description..: Shown to the user if the system can't find the
  2859.                        user's name in the user list. At this moment is
  2860.                        SuperBBS not aware of the language the user is
  2861.                        using or want to use. This file should there-
  2862.                        fore contain all available languages.
  2863.  
  2864.         Name.........: NOYELL
  2865.         Type.........: ANS/ASC
  2866.         Description..: Shown to the user when his/her name was found
  2867.                        in the NOYELL.CTL control file and the user
  2868.                        tries this option.
  2869.  
  2870.         Name.........: PAGEABRT
  2871.         Type.........: ANS/ASC
  2872.         Description..: Shown to the user when the Sysop aborts the
  2873.                        yell from the user.
  2874.  
  2875.         Name.........: PAGED
  2876.         Type.........: ANS/ASC
  2877.         Description..: Shown to the user after a yell for the Sysop,
  2878.                        incase the Sysop didn't answer.
  2879.  
  2880.         Name.........: PAGEQUES
  2881.         Type.........: ANS/ASC
  2882.         Description..: Shown to the user when yelling the Sysop, just
  2883.                        before the user is asked for the reason of the
  2884.                        page.
  2885.  
  2886.         Name.........: PASSWORD
  2887.         Type.........: ANS/ASC
  2888.         Description..: Shown to the new user just before the system
  2889.                        asks for a password, or just before the user
  2890.                        has the option to change his/her password.
  2891.  
  2892.         Name.........: PRIVATE
  2893.         Type.........: ANS/ASC
  2894.         Description..: Shown to the user if your system is a private
  2895.                        system and a non-registered user is trying to
  2896.                        get in. The user will be disconnected after
  2897.                        displaying the file.
  2898.  
  2899.         --------------------------------------------------------------
  2900.         SuperBBS v1.16 - Part B                               Page 148
  2901.  
  2902.  
  2903.         Name.........: RATIO
  2904.         Type.........: ANS/ASC
  2905.         Description..: Shown to the user when the upload/download file
  2906.                        ratio is exceeded as configured in CONFIG.EXE.
  2907.  
  2908.         Name.........: RATIOK
  2909.         Type.........: ANS/ASC
  2910.         Description..: Shown to the user when the upload/download
  2911.                        kbytes ratio is exceeded as configured in
  2912.                        CONFIG.EXE.
  2913.  
  2914.         Name.........: READHELP
  2915.         Type.........: ANS/ASC
  2916.         Description..: Shown to the user if he/she asks for help with
  2917.                        the read, scan and quickscan commands.
  2918.  
  2919.         Name.........: SECxxxxx
  2920.         Type.........: ANS/ASC
  2921.         Description..: Shown to the user just after the welcome screen
  2922.                        if he/she has the security level 'xxxxx'.
  2923.                        'xxxxx' has to be a value between 0 and 32000.
  2924.                        (SEC20.ANS will be shown to security level 20
  2925.                        user's.) If this file is not found, SuperBBS
  2926.                        will look for a SECALL.A?? file.
  2927.  
  2928.         Name.........: SECALL
  2929.         Type.........: ANS/ASC
  2930.         Description..: Shown to the user if for his/her security level
  2931.                        no SECxxxxx.A?? file is available.
  2932.  
  2933.         Name.........: TIMEWARN
  2934.         Type.........: ANS/ASC
  2935.         Description..: Shown to the user when his/her time is adjusted
  2936.                        due to an upcoming event.
  2937.  
  2938.         Name.........: TOOSLOW
  2939.         Type.........: ANS/ASC
  2940.         Description..: Shown to the user when trying to logon to the
  2941.                        system at a bps rate which is not fast enough,
  2942.                        as configured in CONFIG.EXE.
  2943.  
  2944.         Name.........: TRASHCAN
  2945.         Type.........: ANS/ASC
  2946.         Description..: Shown to the user when his/her name was found
  2947.                        in the TRASHCAN.CTL list. The user will be
  2948.                        disconnected after displaying the file.
  2949.  
  2950.         Name.........: VIP
  2951.         Type.........: ANS/ASC
  2952.         Description..: Shown to the user after the welcome screen if
  2953.                        his/her name was found in the VIP.CTL list.
  2954.  
  2955.  
  2956.  
  2957.         --------------------------------------------------------------
  2958.         SuperBBS v1.16 - Part B                               Page 149
  2959.  
  2960.  
  2961.         Name.........: WELCOME
  2962.         Type.........: ANS/ASC
  2963.         Description..: Shown to the user after he/she entered her name
  2964.                        and password.
  2965.  
  2966.         Name.........: WELCOME1
  2967.         Type.........: ANS/ASC
  2968.         Description..: Shown just after the welcome screen.
  2969.  
  2970.         Name.........: XFERHELP
  2971.         Type.........: ANS/ASC
  2972.         Description..: Shown to the user when the user asks for help
  2973.                        with the transfer protocols and file transfer.
  2974.  
  2975.         Name.........: XFERPROT
  2976.         Type.........: ANS/ASC
  2977.         Description..: Shown to the user when he/she selects the down-
  2978.                        load option. This file will replace the normal
  2979.                        build in protocol list.
  2980.  
  2981.         9.3       .CTL, .LNG and .BBS Support files
  2982.         --------------------------------------------------------------
  2983.  
  2984.         Besides the ANSI and ASCII files, SuperBBS uses a couple of
  2985.         .CTL, .LNG and .BBS files to control his behaviour. The .CTL
  2986.         files are all plain ASCII files and can be edited with every
  2987.         normal texteditor, even Edlin if you like. The .BBS files are
  2988.         all controlled through the CONFIG.EXE program. The .LNG files
  2989.         are language files and are controlled through the LCONFIG.EXE
  2990.         program. The .BBS and .LNG files are mentioned here as refer-
  2991.         ence, so you know what every file is for. Their set up is
  2992.         explained in detail in chapter 3.
  2993.  
  2994.         Type.........: *.LNG
  2995.         Description..: Language support files.
  2996.  
  2997.         Type.........: AREAS.BBS
  2998.         Description..: Not a file needed for SuperBBS, but most
  2999.                        echomail processors need this file, that's why
  3000.                        we mention it. It contains information about
  3001.                        your message areas and who to send them to. The
  3002.                        format is as follows:
  3003.  
  3004.                        <Area Nr.> <Description_of_area> <Destination>
  3005.  
  3006.                        Don't use the first three lines of the file.
  3007.                        Just put a ';' in there. This is just a plain
  3008.                        ASCII file.
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.         --------------------------------------------------------------
  3016.         SuperBBS v1.16 - Part B                               Page 150
  3017.  
  3018.  
  3019.         Type.........: ANSIF.CTL
  3020.         Description..: It is now possible to any text at logon to your
  3021.                        users. This is done by making an ASCII file
  3022.                        called ANSIF.CTL. SuperBBS will show all files
  3023.                        listed in this file to every user at logon. The
  3024.                        file looks like this:
  3025.  
  3026.                        LOGON
  3027.                        IMPORT
  3028.                        C:\SUPERBBS\SBBSHQ.TXT
  3029.  
  3030.                        If no extension is included, SuperBBS will show
  3031.                        the ANSI or ASCII file, depending on the user
  3032.                        settings. In our example SuperBBS would show
  3033.                        LOGON.ANS if the user has ANSI enabled, other-
  3034.                        wise LOGON.ASC would be shown. These files have
  3035.                        to be in the directories as specified by the
  3036.                        configuration of the language files. You can
  3037.                        show however every file you want by including
  3038.                        the path to the file, like the third file in
  3039.                        the example. The file will be displayed as the
  3040.                        DOS command TYPE would do, so viewing binary
  3041.                        files is not possible, but ANSI is possible.
  3042.  
  3043.         Type.........: BADALIAS.CTL
  3044.         Description..: Contains names which you as Sysop don't want to
  3045.                        be used as aliases on your system. The format
  3046.                        of this ASCII file is:
  3047.  
  3048.                             Bad alias
  3049.                             Bad alias
  3050.                             Bad alias
  3051.  
  3052.                        You can make this file with every normal ASCII
  3053.                        text editor.
  3054.  
  3055.         Type.........: CONFIG.BBS
  3056.         Description..: Contains the complete setup from your system.
  3057.                        This file should never be deleted, because you
  3058.                        will have to setup your system again.
  3059.  
  3060.         Type.........: DOORS.BBS
  3061.         Description..: Configuration file for the doors you have set
  3062.                        up in the configuration program.
  3063.  
  3064.         Type.........: DORINFO1.DEF
  3065.         Description..: One of two files, the other is the EXITINFO.BBS
  3066.                        file, which contains information to be used by
  3067.                        programs running outside SuperBBS. These files
  3068.                        are generated when you do a type 7 or 15 exit.
  3069.  
  3070.  
  3071.  
  3072.  
  3073.         --------------------------------------------------------------
  3074.         SuperBBS v1.16 - Part B                               Page 151
  3075.  
  3076.  
  3077.         Type.........: ECHOORIG.CTL
  3078.         Description..: Plain ASCII file. With this file it is possible
  3079.                        to have a different origin line in every mail
  3080.                        area. The format of the file is as follows:
  3081.  
  3082.                        <AreaNr.> <Origin line>
  3083.                        <AreaNr.> <Origin line>
  3084.  
  3085.                        SuperBBS searches for this file in the direc-
  3086.                        tory where your BOARDS.BBS file is situated.
  3087.                        You can either edit this file with a normal
  3088.                        ASCII editor or through the configuration pro-
  3089.                        gram.
  3090.  
  3091.         Type.........: EXITINFO.BBS
  3092.         Description..: One of two files, the other is the DORINFO1.DEF
  3093.                        file, which contains information to be used by
  3094.                        programs running outside SuperBBS. These files
  3095.                        are generated when you do a type 7 or 15 exit.
  3096.  
  3097.         Type.........: FILES.CTL
  3098.         Description..: This file, which is a plain ASCII file, gives
  3099.                        you control over the files in your filebase. It
  3100.                        is possible to assign passwords to files, spec-
  3101.                        ily unwanted files and give free files. Use
  3102.                        this file as follows:
  3103.  
  3104.                        <Filename>     /FREE
  3105.                        <Filename>     /UNWANTED
  3106.                        <Filename>     /PWD=<password>
  3107.  
  3108.                        You can use wildcards in the filenames. If you
  3109.                        don't specify a directory, the option will work
  3110.                        in all file areas. Here's an example:
  3111.  
  3112.                        SBBS_111.ZIP   /FREE
  3113.                        BETA_112.ZIP   /PWD=BETATEST /FREE
  3114.                        *.GIF          /UNWANTED
  3115.                        C:\TMP\ZIP.ZIP /FREE
  3116.  
  3117.                        This will make the SBBS file free, protect the
  3118.                        free file Beta with a password, tells users
  3119.                        .GIF files are not welcome and makes the
  3120.                        ZIP.ZIP in the TMP directory also free.
  3121.  
  3122.         Type.........: FLSEARCH.BBS
  3123.         Description..: Contains all information about your file areas.
  3124.                        Location, securitylevels, flagsettings, age to
  3125.                        have access and if in the menu templating is
  3126.                        stored in this file.
  3127.  
  3128.  
  3129.  
  3130.  
  3131.         --------------------------------------------------------------
  3132.         SuperBBS v1.16 - Part B                               Page 152
  3133.  
  3134.  
  3135.         Type.........: LASTREAD.BBS
  3136.         Description..: Contains information about every user and
  3137.                        his/her lastread message number. Never delete
  3138.                        this file, because all message will be
  3139.                        displayed as new messages to the user's.
  3140.  
  3141.         Type.........: LIMITS.BBS
  3142.         Description..: Contains the information about userlevels and
  3143.                        their limits. SuperBBS checks this file to find
  3144.                        the information about the userlevels.
  3145.  
  3146.         Type.........: MSGIDX.BBS / MSGINFO.BBS / MSGTOIDX.BBS /
  3147.                        MSGHDR.BBS / MSGTXT.BBS
  3148.         Description..: Contains the information about the messages on
  3149.                        your system. If you want to start with a new
  3150.                        and empty database, delete these files.
  3151.  
  3152.         Type.........: NAMEIDX.BBS
  3153.         Description..: SuperBBS uses this file to make the userfile
  3154.                        search a lot faster. It is a small file used by
  3155.                        SuperBBS. Note that if you run non SuperBBS
  3156.                        software to pack/edit your userbase, you will
  3157.                        have to run USERPACK.EXE everytime after that
  3158.                        program. You can also switch the use of this
  3159.                        file of in the configuration program, but we
  3160.                        strongly suggest you do this only when nothing
  3161.                        else will work or you are having problems with
  3162.                        NAMEIDX.BBS searches.
  3163.  
  3164.         Type.........: NOAGECHK.CTL
  3165.         Description..: When a users name is found in this plain ASCII
  3166.                        control file, this user will be able to login
  3167.                        to your system, even when he/she would be too
  3168.                        young, as specified in the configuration of
  3169.                        your system. The format is similar to the
  3170.                        trashcan file.
  3171.  
  3172.         Type.........: NOBCHECK.CTL
  3173.         Description..: When a user logs on to your system and his/her
  3174.                        name is found in this plain ASCII control file,
  3175.                        he/she will never have to enter his/her birth-
  3176.                        day as a verification check. The file format is
  3177.                        the same as the trashcan file.
  3178.  
  3179.         Type.........: NOCHAT.CTL
  3180.         Description..: When a users name is found in this plain ASCII
  3181.                        file, this user is never able to use the node-
  3182.                        chat function. A file called NOCHAT.A?? will be
  3183.                        displayed to the user. The format is similar to
  3184.                        that of the trashcan file.
  3185.  
  3186.  
  3187.  
  3188.  
  3189.         --------------------------------------------------------------
  3190.         SuperBBS v1.16 - Part B                               Page 153
  3191.  
  3192.  
  3193.         Type.........: NODEIDX.SBS / NODEINC.SBS
  3194.         Description..: The two index files generated by the
  3195.                        SBBSNODE.EXE program from the raw nodelist.
  3196.                        These two files are needed if you use the node-
  3197.                        list support in SuperBBS.
  3198.  
  3199.         Type.........: NOYELL.CTL
  3200.         Description..: When a users name is found in this plain Ascii
  3201.                        control file, this user will not be able to
  3202.                        page the Sysop for a chat. The file NOYELL.A??
  3203.                        will be displayed to the user. The format is
  3204.                        similar to that of the trashcan file.
  3205.  
  3206.         Type.........: PFILES.BBS
  3207.         Description..: Contains information about private uploads done
  3208.                        to you. This is a normal ASCII file. All pri-
  3209.                        vate upload descriptions are stored in this
  3210.                        file.
  3211.  
  3212.         Type.........: PHONENUM.CTL
  3213.         Description..: This file prevents users from entering illegal
  3214.                        phonenumbers. It works the same way as the
  3215.                        trashcan file. When a phonenumber is entered,
  3216.                        it is compared to this list and when there is a
  3217.                        match, the user is warned. When a string is
  3218.                        found _anywhere_ in the entered phonenumber,
  3219.                        SuperBBS will react. Here is an example:
  3220.  
  3221.                        000-
  3222.                        -0000
  3223.                        06-11
  3224.  
  3225.                        Phonenumbers containing these strings
  3226.                        _ANYWHERE_ in the number will not be accepted.
  3227.                        For example 956-00001234 or 9006-110023 will
  3228.                        not be accepted by SuperBBS. Don't make your
  3229.                        control file to complex, use common sense.
  3230.  
  3231.         Type.........: SBBSBUSY.?
  3232.         Description..: This file is created by SuperBBS while running.
  3233.                        The ? is the node number. This file is even
  3234.                        created on single line systems. Since this file
  3235.                        is created in the common directory, check your
  3236.                        configuration.
  3237.  
  3238.         Type.........: SLCALLER.BBS
  3239.         Description..: Contains information about the last 15 users to
  3240.                        your BBS. You can delete this file if you want,
  3241.                        but there should be no reason for it.
  3242.  
  3243.         Type.........: SPROTO.BBS
  3244.         Description..: Configuration file for the external protocols.
  3245.  
  3246.  
  3247.         --------------------------------------------------------------
  3248.         SuperBBS v1.16 - Part B                               Page 154
  3249.  
  3250.  
  3251.         Type.........: SUSERS.BBS
  3252.         Description..: Contains the extra user information like age,
  3253.                        birthday, sex etc. Only delete this file if
  3254.                        your userbase is messy and you want to clean it
  3255.                        up. SuperBBS will ask every user for the needed
  3256.                        information again.
  3257.  
  3258.         Type.........: TIMELOG.BBS
  3259.         Description..: Contains information about the usage of the
  3260.                        BBS. The usage log is created out of this file.
  3261.                        If you want to start all over with your usage
  3262.                        log, delete this file.
  3263.  
  3264.         Type.........: TRASHCAN.CTL
  3265.         Description..: Contains user names you don't want to have on
  3266.                        your board, like Sysop, Dr., Hacker etc. This
  3267.                        is a plain ASCII file in the following format:
  3268.  
  3269.                             User name
  3270.                             User name
  3271.                             User name
  3272.  
  3273.         Type.........: USERDOES.?
  3274.         Description..: If SuperBBS finds the file USERDOES.?, where
  3275.                        the ? is the node number, in the main SuperBBS
  3276.                        directory, it will display it when menu type 75
  3277.                        is used. This file allows you to show a more
  3278.                        specific line when the user asks the status of
  3279.                        the other line. When this file contains "Play-
  3280.                        ing Tradewars", SuperBBS will show this if the
  3281.                        user executes menu type 75 (with /S option).
  3282.  
  3283.         Type.........: USERS.BBS
  3284.         Description..: Contains the information about the users. All
  3285.                        normal user information is stored in this file.
  3286.                        Only delete this file if you want to start with
  3287.                        0 user's. Backup this file often to prevent
  3288.                        damage to your userfile if something happens.
  3289.  
  3290.         Type.........: VIP.CTL
  3291.         Description..: Contains information about special users to
  3292.                        your BBS system. SuperBBS will show the file
  3293.                        VIP.A?? to them at logon. This is a plain ASCII
  3294.                        file with the following format:
  3295.  
  3296.                             <User name>
  3297.                             <User name>
  3298.                             <User name>
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.         --------------------------------------------------------------
  3306.         SuperBBS v1.16 - Part B                               Page 155
  3307.  
  3308.  
  3309.         SuperBBS uses four logfiles for storing system information.
  3310.         One type you hopefully never have to see. These files are:
  3311.  
  3312.         Type.........: ERRORS.LOG & ERRORS.BBS
  3313.         Description..: Contains all errors which occur during oper-
  3314.                        ation of SuperBBS. Please take note of these
  3315.                        files and send the information to us, when you
  3316.                        come across an error. Send this information to
  3317.                        our support nodes or the SuperBBS HQ.
  3318.  
  3319.         Type.........: SBBSDOWN.LOG
  3320.         Description..: Contains all downloads done from your system
  3321.                        and the names of the user who downloaded the
  3322.                        file.
  3323.  
  3324.         Type.........: SBBSUP.LOG
  3325.         Description..: Contains all uploads done to your system and
  3326.                        the name of the uploader.
  3327.  
  3328.         Type.........: SYSTEM.LOG
  3329.         Description..: Contains all information about what the user
  3330.                        did on your system. Information like name,
  3331.                        userlevel, alias, wrong passwords, exits to
  3332.                        doors and time on-line are stored in here. This
  3333.                        file is a plain ASCII file. If this file is
  3334.                        missing, SuperBBS will create it the next time
  3335.                        it is run, so you can delete this file as many
  3336.                        times as you wish.
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.         --------------------------------------------------------------
  3364.         SuperBBS v1.16 - Part B                               Page 156
  3365.  
  3366.  
  3367.         Chapter 10.    Questionnaire language
  3368.         ==============================================================
  3369.  
  3370.         10.1      General information
  3371.         --------------------------------------------------------------
  3372.  
  3373.         SuperBBS has a powerful questionnaire language available to
  3374.         the Sysop for designing question files. SuperBBS will run the
  3375.         questionnaire called NEWUSER.Q-A if a new user enters your
  3376.         system and the file is found. Answers will be stored under the
  3377.         same filename, but with the extension .ASW. All questionnaires
  3378.         have to have the extension .Q-A and all answer files will have
  3379.         the extension .ASW. You can design as many questionnaires as
  3380.         you like. You can run a questionnaire from a menutype 12. On
  3381.         the optional datafield, you have to supply the name of the
  3382.         questionnaire.
  3383.  
  3384.         10.2      Available commands
  3385.         --------------------------------------------------------------
  3386.  
  3387.         Here's a list of the available commands in the questionnaires:
  3388.  
  3389.         Used codes:    <.......> = Mandatory
  3390.                        [.......] = Optional
  3391.  
  3392.         Command.....:  ASK <length> <variable> [default]
  3393.         Description.:  Asks for a string from the user. Length defines
  3394.                        the number of characters the answer can take,
  3395.                        the variable is the answer number, which you
  3396.                        can use in combination with other commands. The
  3397.                        option Default allows you to enter some infor-
  3398.                        mation as default in the answer field. If you
  3399.                        use as default USERNAME, this will be replaced
  3400.                        through the username of the user answering the
  3401.                        questionnaire.
  3402.         Example.....:  ASK 40 1 USERNAME
  3403.  
  3404.         Command.....:  CAPITALIZE <on/off>
  3405.         Description.:  If capitalize is on, all first letters of the
  3406.                        words entered in an answer field will be capi-
  3407.                        talized. If off, the user decides if a letter
  3408.                        is capitalized through the use of his/her
  3409.                        Shift(-Lock) key.
  3410.         Example.....:  CAPITALIZE ON
  3411.  
  3412.         Command.....:  CHANGECOLOR <foreground> <background>
  3413.         Description.:  Changes colour to the given combination. Fore-
  3414.                        ground (or textcolour) can be between 0 and 15,
  3415.                        background between 0 and 7. See earlier in this
  3416.                        documentation for a complete list of the col-
  3417.                        ours.
  3418.         Example.....:  CHANGECOLOR 14 1
  3419.  
  3420.  
  3421.         --------------------------------------------------------------
  3422.         SuperBBS v1.16 - Part B                               Page 157
  3423.  
  3424.  
  3425.         Command.....:  CLEARSCREEN
  3426.         Description.:  Clears the screen if user has selected CLS
  3427.                        codes.
  3428.         Example.....:  CLEARSCREEN
  3429.  
  3430.         Command.....:  DISPLAY <"text">
  3431.         Description.:  Displays a text to the user. The pipe symbol
  3432.                        '|' acts as a carriage return. Every textline
  3433.                        should not exceed the screen width. If no '|'
  3434.                        is given, SuperBBS will continue at the end of
  3435.                        the last line. Use the '|' also after the
  3436.                        GETCHOICE command as the first character of a
  3437.                        textline. You can use as many '|' symbols
  3438.                        behind each other as you like.
  3439.         Example.....:  DISPLAY "Welcome to this BBS system.|"
  3440.  
  3441.         Command.....:  DISPLAYASW <variable>
  3442.         Description.:  Shows the answer given to the question given as
  3443.                        the variable. This should be the same variable
  3444.                        as used with the question.
  3445.         Example.....:  DISPLAYASW 1
  3446.  
  3447.         Command.....:  DISPLAYFILE <filename>
  3448.         Description.:  Displays the file given as filename from the
  3449.                        textfile directory. If the user has ANSI
  3450.                        enabled this will be the ANSI version if avail-
  3451.                        able, otherwise the ASCII version is shown.
  3452.                        SuperBBS first looks in the directory specified
  3453.                        in the language file, then in the directory
  3454.                        specified in CONFIG.EXE.
  3455.         Example.....:  DISPLAYFILE WELCOME
  3456.  
  3457.         Command.....:  DOMENUC <menutype> <"data">
  3458.         Description.:  This command will run the menu command (see
  3459.                        list for numbers) given as data in the menutype
  3460.                        field. The information given in the data field
  3461.                        will be displayed to the user.
  3462.         Example.....:  DOMENUC 11 "Yelling Sysop"
  3463.  
  3464.         Command.....:  ENDIF
  3465.         Description.:  Use this command as the end of an IF loop. (See
  3466.                        the IF command.)
  3467.         Example.....:  ENDIF
  3468.  
  3469.         Command.....:  EXEC <command>
  3470.         Description.:  Executes the program given as the command
  3471.                        option. This allows you to execute an external
  3472.                        program. This program should be in the path or
  3473.                        current directory.
  3474.         Example.....:  EXEC USERCHEC.EXE
  3475.  
  3476.  
  3477.  
  3478.  
  3479.         --------------------------------------------------------------
  3480.         SuperBBS v1.16 - Part B                               Page 158
  3481.  
  3482.  
  3483.         Command.....:  GOTO <label>
  3484.         Description.:  This command allows you to jump to a character
  3485.                        or value. Label must be ONE character or a
  3486.                        value. The place GOTO will jump to is deter-
  3487.                        mined by the same character or value preceded
  3488.                        by a colon ':'. So the command GOTO A, will
  3489.                        jump to :A.
  3490.         Example.....:  GOTO B
  3491.  
  3492.         Command.....:  GETCHOICE <options> <variable> [default]
  3493.         Description.:  This command allows you to ask the user a ques-
  3494.                        tion, with only a limited one character answer
  3495.                        available. Options are the characters which are
  3496.                        valid for this answer, variable is the question
  3497.                        number the answer should be stored under in
  3498.                        memory and default is the default answer, so
  3499.                        when a user just presses ENTER, it will default
  3500.                        to the answer stated in default.
  3501.         Example.....:  GETCHOICE YN 2 Y
  3502.  
  3503.         Command.....:  IF <variable = "string">
  3504.         Description.:  This command allows you to jump over certain
  3505.                        parts of your questionnaire if the compiled
  3506.                        variable does not match the given string. Vari-
  3507.                        able is the question number stored in memory
  3508.                        and string is the string to match. SuperBBS
  3509.                        will compile the user's answer and compare it
  3510.                        to the string. If this doesn't match, SuperBBS
  3511.                        will jump to the first ENDIF found.
  3512.         Example.....:  IF 1 = "Frank Hemmelder"
  3513.  
  3514.         Command.....:  OUTPUTANSWER ["string"] <variable>
  3515.         Description.:  This commands allow you to store the answers
  3516.                        given by the user in an ASCII file with the
  3517.                        same name as the questionnaire, but with an ASW
  3518.                        extension. String is the text which should be
  3519.                        placed in front of the answer, variable is the
  3520.                        number of the answer stored in memory.
  3521.         Example.....:  OUTPUTANSWER "Full name : " 1
  3522.  
  3523.         Command.....:  POSTINFO
  3524.         Description.:  This command will write the current system
  3525.                        time, data and the username to the answer file.
  3526.                        This command should be used in front of the
  3527.                        OUTPUTANSWER lines. Some programs, like
  3528.                        READANS.EXE, allows you to upgrade newusers
  3529.                        easily by reading the answers in the
  3530.                        NEWUSER.ASW file, but they need the information
  3531.                        from POSTINFO to separate the different users.
  3532.         Example.....:  POSTINFO
  3533.  
  3534.  
  3535.  
  3536.  
  3537.         --------------------------------------------------------------
  3538.         SuperBBS v1.16 - Part B                               Page 159
  3539.  
  3540.  
  3541.         Command.....:  QUIT
  3542.         Description.:  Ends the questionnaire. This does not mean this
  3543.                        command has to be at the end of all the ques-
  3544.                        tions. If you use the IF and ENDIF commands,
  3545.                        this could be half way through your question-
  3546.                        naire.
  3547.         Example.....:  QUIT
  3548.  
  3549.         Command.....:  SETFLAG <flag> <on/off>
  3550.         Description.:  Allows you to change a flagsetting from the
  3551.                        current user. Flag should be a character/number
  3552.                        combination, flags are numbered A1 to D8, and
  3553.                        they should be followed by the on or off com-
  3554.                        mand.
  3555.         Example.....:  SETFLAG B5 ON
  3556.  
  3557.         Command.....:  SETSECURITY <level>
  3558.         Description.:  Allows you to change the userlevel. Level
  3559.                        should be the new level.
  3560.         Example.....:  SETSECURITY 0
  3561.  
  3562.         Command.....:  WAITENTER
  3563.         Description.:  This command displays the 'Press ENTER to
  3564.                        continue' string and waits for the user to
  3565.                        press the ENTER key. The 'Press ENTER....' will
  3566.                        be done in the current language.
  3567.         Example.....:  WAITENTER
  3568.  
  3569.         10.3      NEWUSER.Q-A & EXPIRED.Q-A
  3570.         --------------------------------------------------------------
  3571.  
  3572.         The NEWUSER.Q-A is run, when available, everytime a new user
  3573.         logs on to your system. Here you can ask questions like the
  3574.         address of the user, his/her requirements or anything else you
  3575.         would like to know, before you give access to your system. (An
  3576.         example is below.)
  3577.  
  3578.         The EXPIRED.Q-A is run everytime a user's expiration date has
  3579.         reached 0. In this questionnaire you can change levels, change
  3580.         flagsettings, tell the user how he can get his/her level back
  3581.         and many other things.
  3582.  
  3583.         You can use as many questionnaires as you might need, but
  3584.         these two are special.
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.         --------------------------------------------------------------
  3596.         SuperBBS v1.16 - Part B                               Page 160
  3597.  
  3598.  
  3599.         10.4      Questionnaire example
  3600.         --------------------------------------------------------------
  3601.  
  3602.         Now let's have a look at this little example. You could use
  3603.         it, but I recommend you change it and make it better. It will
  3604.         first display a textfile to the user, stating the rules of the
  3605.         BBS, then ask the most important questions and asks if you are
  3606.         a Sysop. If you are, you'll be able to enter your BBS informa-
  3607.         tion. Then all answers are displayed, so the user can check
  3608.         them and eventually start all over if he/she made a mistake.
  3609.         This is an example of a NEWUSER.Q-A questionnaire.
  3610.  
  3611.              CLEARSCREEN
  3612.              DISPLAYFILE RULES
  3613.              CHANGCOLOR 11 0
  3614.              CAPITALIZE ON
  3615.              DISPLAY "Do you still want to continue? (Y/n) "
  3616.              GETCHOICE YN 1 Y
  3617.              CAPITALIZE OFF
  3618.              IF 1 = "N"
  3619.              SETSECURITY 0
  3620.              CHANGECOLOR 14 4
  3621.              DISPLAY "You will be logged off now!"
  3622.              QUIT
  3623.              ENDIF
  3624.              :A
  3625.              CLEARSCREEN
  3626.              CHANGECOLOR 10 0
  3627.              DISPLAY "|Your full name........: "
  3628.              ASK 40 2 USERNAME
  3629.              CHANGECOLOR 10 0
  3630.              DISPLAY "Address................: "
  3631.              ASK 40 3
  3632.              CHANGECOLOR 10 0
  3633.              DISPLAY "City and State.........: "
  3634.              ASK 40 4
  3635.              CHANGECOLOR 10 0
  3636.              DISPLAY "Telephone number.......: "
  3637.              ASK 15 5
  3638.              CHANGECOLOR 10 0
  3639.              DISPLAY "|Are you a Sysop? (y/N) "
  3640.              CAPITALIZE ON
  3641.              GETCHOICE YN 6 N
  3642.              CAPITALIZE OFF
  3643.              IF 6 = "Y'
  3644.              CHANGECOLOR 10 0
  3645.              DISPLAY "BBS name...............: "
  3646.              ASK 40 7
  3647.              CHANGECOLOR 10 0
  3648.              DISPLAY "Telephone number.......: "
  3649.              ASK 15 8
  3650.              ENDIF
  3651.              (Continued on next page)
  3652.  
  3653.         --------------------------------------------------------------
  3654.         SuperBBS v1.16 - Part B                               Page 161
  3655.  
  3656.  
  3657.              CHANGECOLOR 13 0
  3658.              DISPLAY "|Thank you for filling out all the questions."
  3659.              DISPLAY "|Now you can check your answers.|
  3660.              WAITENTER
  3661.              CLEARSCREEN
  3662.              CHANGECOLOR 11 0
  3663.              DISPLAY "|These are your answers: "
  3664.              CHANGECOLOR 10 0
  3665.              DISPLAY "|Name..................: "
  3666.              DISPLAYASW 2
  3667.              CHANGECOLOR 10 0
  3668.              DISPLAY "Address................: "
  3669.              DISPLAYASW 3
  3670.              CHANGECOLOR 10 0
  3671.              DISPLAY "City and State.........: "
  3672.              DISPLAYASW 4
  3673.              CHANGECOLOR 10 0
  3674.              DISPLAY "Telephone number.......: "
  3675.              DISPLAYASW 5
  3676.              CHANGECOLOR 10 0
  3677.              IF 6 = "Y'
  3678.              CHANGECOLOR 10 0
  3679.              DISPLAY "BBS name...............: "
  3680.              DISPLAYASW 7
  3681.              CHANGECOLOR 10 0
  3682.              DISPLAY "Telephone number.......: "
  3683.              DISPLAYASW 8
  3684.              ENDIF
  3685.              CHANGECOLOR 14 1
  3686.              DISPLAY "|All answers correct? (Y/n)
  3687.              CAPITALIZE ON
  3688.              GETCHOICE YN 9 Y
  3689.              CAPITALIZE OFF
  3690.              IF 9 = "N"
  3691.              GOTO A
  3692.              ENDIF
  3693.              CHANGECOLOR 12 0
  3694.              DISPLAY "|Thank you for answering all questions."
  3695.              DISPLAY "|The answers are now stored."
  3696.              POSTINFO
  3697.              OUTPUTANSWER "Name.........: " 2
  3698.              OUTPUTANSWER "Address......: " 3
  3699.              OUTPUTANSWER "City & State.: " 4
  3700.              OUTPUTANSWER "Phone........: " 5
  3701.              IF 6 = "Y"
  3702.              OUTPUTANSWER "BBS name.....: " 7
  3703.              OUTPUTANSWER "Phone........: " 8
  3704.              QUIT
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.         --------------------------------------------------------------
  3712.         SuperBBS v1.16 - Part B                               Page 162
  3713.  
  3714.  
  3715.         Chapter 11.    Running SuperBBS
  3716.         ==============================================================
  3717.  
  3718.         11.1      General information
  3719.         --------------------------------------------------------------
  3720.  
  3721.         SuperBBS can be run as a stand alone program or with a front-
  3722.         end mailer like Frontdoor (TM), D'Bridge (TM) or any other
  3723.         mailer program. In both cases you need to run SuperBBS from a
  3724.         batchfile. Two examples are given in the appendixes of this
  3725.         documentation. One for running SuperBBS as stand alone program
  3726.         and one for running SuperBBS in combination with a mailer.
  3727.  
  3728.         If you are using SuperBBS with a mailer, please read all the
  3729.         documentation of the mailer program carefully, so you know how
  3730.         the two programs interact with each other.
  3731.  
  3732.         11.2      Command line options
  3733.         --------------------------------------------------------------
  3734.  
  3735.         SuperBBS can be started by running the program BBS.EXE without
  3736.         any parameter. This will put the main SuperBBS program on-
  3737.         line. You will see a SuperBBS screen with some information,
  3738.         like time and date, last user and more. When this screen is
  3739.         visible (or the screensaver is working) you have two options:
  3740.  
  3741.              [L]       This will put the BBS program in local mode.
  3742.                        This way you will be able to connect to the
  3743.                        system, just like you are running the system
  3744.                        remotely. Beware that if you have any door
  3745.                        programs installed which uses a Carrier Detect
  3746.                        monitor, these won't run because there is no
  3747.                        carrier signal available.
  3748.  
  3749.              [ESCAPE]  Shutdown SuperBBS and returns you to the DOS
  3750.                        prompt.
  3751.  
  3752.         There is a third option, this is that you get a caller on-
  3753.         line. SuperBBS will connect at the right modem speed and will
  3754.         handle the connection. A carrier check is build in, so if the
  3755.         user disconnects, the system will restart (if run from a
  3756.         batchfile).
  3757.  
  3758.         To start the BBS program in local mode, use the -L option.
  3759.         This option and the other command line options are as follows:
  3760.  
  3761.         Type.........: -Bxxxx
  3762.         Description..: Starts SuperBBS with a BPS rate of xxxx. This
  3763.                        is a value between 300 and 38400, depending on
  3764.                        your modemspeed. This option is mostly used in
  3765.                        a batchfile running a mailer, telling SuperBBS
  3766.                        at what BPS rate the user is calling.
  3767.  
  3768.  
  3769.         --------------------------------------------------------------
  3770.         SuperBBS v1.16 - Part B                               Page 163
  3771.  
  3772.  
  3773.         Type.........: -Exxx
  3774.         Description..: Tells SuperBBS to exit the call with errorlevel
  3775.                        xxx. This can be handy if you wish to start
  3776.                        some external program after SuperBBS finishes.
  3777.  
  3778.         Type.........: -L
  3779.         Description..: Starts the SuperBBS program in Local mode.
  3780.  
  3781.         Type.........: -Oxxxxxx
  3782.         Description..: This option will increase the overlay buffer
  3783.                        with xxxxxx bytes. (For a 286-12 Mhz machine
  3784.                        this should be somewhere between 50000 and
  3785.                        100000 bytes.) Experiment a bit with it to find
  3786.                        the right value. This will speed up the Super-
  3787.                        BBS operation on slow machines or machines with
  3788.                        no EMS. This option defaults to 50000 bytes.
  3789.  
  3790.         Type.........: -Px
  3791.         Description..: Tells SuperBBS what COM port to use for the
  3792.                        connection. You can use this command to over-
  3793.                        ride the settings in the configuration program.
  3794.                        Don't forget to use the -Px option also when
  3795.                        returning from a type 15 exit.
  3796.  
  3797.         Type.........: -R
  3798.         Description..: Tells SuperBBS it is already connected to a
  3799.                        caller and just has to restart the main pro-
  3800.                        gram. This option is used after a type 15 exit.
  3801.  
  3802.         Type.........: -T
  3803.         Description..: Tells SuperBBS the user has -T time left. This
  3804.                        time is forwarded by the mailer, to prevent an
  3805.                        overshoot of an event. Frontdoor uses this in
  3806.                        it's DOBBS.BAT file. (Frontdoor v2.01 also has
  3807.                        a bug at 14400 EC, stating the -B command as
  3808.                        9600 Bps, instead of the correct Bps). See your
  3809.                        mailer manual for further information on call-
  3810.                        ing the BBS.
  3811.  
  3812.         Type.........: -*
  3813.         Description..: Tells SuperBBS not to load the overlay file in
  3814.                        EMS.
  3815.  
  3816.         Combinations of these parameters are possible. These parame-
  3817.         ters are not necessary to run the SuperBBS program, but are
  3818.         sometimes needed.
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.  
  3826.  
  3827.         --------------------------------------------------------------
  3828.         SuperBBS v1.16 - Part B                               Page 164
  3829.  
  3830.  
  3831.         11.3      On-line Sysop keys
  3832.         --------------------------------------------------------------
  3833.  
  3834.         While the SuperBBS is on-line and a caller is in the system,
  3835.         the sysop has several keys which he/she can use. All Fx keys
  3836.         refer to the status line which is shown at the bottom of the
  3837.         local screen. All keys apply to the current user on-line. All
  3838.         the available keys are:
  3839.  
  3840.         Type.........: F1
  3841.         Description..: Shows user's information on status line. Name,
  3842.                        city, bps rate, securitylevel, times called,
  3843.                        time left and line number are displayed.
  3844.  
  3845.         Type.........: F2
  3846.         Description..: Shows user's flags.
  3847.  
  3848.         Type.........: F3
  3849.         Description..: Shows user's up/download levels and ratio.
  3850.  
  3851.         Type.........: F4
  3852.         Description..: Shows chat reason (if any) and if the Sysop is
  3853.                        available.
  3854.  
  3855.         Type.........: F5
  3856.         Description..: Shows sysop comment (from SBBSUSER.EXE) and
  3857.                        alias information.
  3858.  
  3859.         Type.........: F6
  3860.         Description..: Shows the current time and date, user's phone
  3861.                        numbers, total calls to system, number of mess-
  3862.                        ages written and last caller.
  3863.  
  3864.         Type.........: F7
  3865.         Description..: Shows the last and first time and date the user
  3866.                        called, and the expiration date of the user.
  3867.  
  3868.         Type.........: F8
  3869.         Description..: Shows the information you have set in the con-
  3870.                        figuration program. This function key if
  3871.                        programmable by you. Note that the maximum line
  3872.                        length cannot be exceeded (80 characters). You
  3873.                        can use all control codes in these two lines.
  3874.  
  3875.         Type.........: F9
  3876.         Description..: Remove status lines from screen. This gives you
  3877.                        the same view as the user.
  3878.  
  3879.         Type.........: F10
  3880.         Description..: Gives information about the on-line keys
  3881.  
  3882.  
  3883.  
  3884.  
  3885.         --------------------------------------------------------------
  3886.         SuperBBS v1.16 - Part B                               Page 165
  3887.  
  3888.  
  3889.         Type.........: ALT-C
  3890.         Description..: Chat with the user. A message will be displayed
  3891.                        to the user at the start and finnish of the
  3892.                        conversation.
  3893.  
  3894.         Type.........: ALT-E
  3895.         Description..: Run the on-line user editor. This allows you to
  3896.                        edit the current user. All changes will be
  3897.                        saved in the user file. A message will be dis-
  3898.                        played to the user, unless you have CapsLock
  3899.                        on.
  3900.  
  3901.         Type.........: ALT-F
  3902.         Description..: Change the current user's flagsettings. All
  3903.                        changes will be saved in the user file. A mess-
  3904.                        age will be displayed to the user, unless you
  3905.                        have CapsLock on.
  3906.  
  3907.         Type.........: ALT-H
  3908.         Description..: Disconnect user without showing GOODBYE.A??.
  3909.  
  3910.         Type.........: ALT-J
  3911.         Description..: Shell to DOS from SuperBBS. SuperBBS can swap
  3912.                        to EMS or disk if allowed through the
  3913.                        CONFIG.EXE program. A message will be displayed
  3914.                        to the user when you shell out and when you
  3915.                        return.
  3916.  
  3917.         Type.........: ALT-L
  3918.         Description..: Locks the user out of your system. He/she will
  3919.                        be disconnected and his/her level will be
  3920.                        lowered to 0.
  3921.  
  3922.         Type.........: ALT-N
  3923.         Description..: Sysop next mode. This will halt the system
  3924.                        after the user currently online has logged of
  3925.                        for a short period and a beep will be heard.
  3926.                        This allows you as the Sysop to enter the BBS.
  3927.                        If after 45 seconds you did not react, the BBS
  3928.                        will be normally restarted. (Or your mailer
  3929.                        will be started.)
  3930.  
  3931.         Type.........: ALT-S
  3932.         Description..: Change the caller's security level. A message
  3933.                        will be displayed to the user, unless CapsLock
  3934.                        is on.
  3935.  
  3936.         Type.........: ALT-T
  3937.         Description..: Change the timelimit for the user for this
  3938.                        call.
  3939.  
  3940.  
  3941.  
  3942.  
  3943.         --------------------------------------------------------------
  3944.         SuperBBS v1.16 - Part B                               Page 166
  3945.  
  3946.  
  3947.         Type.........: ALT-1
  3948.         Description..: Generate line noise. This can be useful if you
  3949.                        want a user off-line.
  3950.  
  3951.         Type.........: ALT-2
  3952.         Description..: Toggle the ratio check for the current user on
  3953.                        or off.
  3954.  
  3955.         Type.........: ALT-3
  3956.         Description..: Set a new download limit for this call.
  3957.  
  3958.         Type.........: ALT-4
  3959.         Description..: Generates a BEEP on the user's console.
  3960.  
  3961.         Type.........: ALT-5
  3962.         Description..: Toggle output to user's screen on or off.
  3963.  
  3964.         Type.........: ALT-6
  3965.         Description..: Toggle user's keyboard on or off.
  3966.  
  3967.         Type.........: Up arrow
  3968.         Description..: Increase time limit with 1 minute.
  3969.  
  3970.         Type.........: Down arrow
  3971.         Description..: Decrease time limit with 1 minute.
  3972.  
  3973.         Type.........: Scroll lock
  3974.         Description..: Toggle Sysop availability on/off. Status lock
  3975.                        on means Sysop not available. Also no messages
  3976.                        are send to the user, when the Sysop changes
  3977.                        the user information.
  3978.  
  3979.         11.4      User's on-line keys
  3980.         --------------------------------------------------------------
  3981.  
  3982.         Just as the Sysop has the user some special keys on-line.
  3983.         These are:
  3984.  
  3985.         Type.........: P
  3986.         Description..: Pause all output from text.
  3987.  
  3988.         Type.........: S
  3989.         Description..: Abort current operation. This works in most
  3990.                        places in the SuperBBS program.
  3991.  
  3992.         Type.........: Ctrl-C
  3993.         Description..: Stops Sysop yell and message scan.
  3994.  
  3995.         Type.........: Ctrl-Y
  3996.         Description..: Clears any input line. (When you have to answer
  3997.                        a question.)
  3998.  
  3999.  
  4000.  
  4001.         --------------------------------------------------------------
  4002.         SuperBBS v1.16 - Part B                               Page 167
  4003.  
  4004.  
  4005.         As of version 1.10, SuperBBS supports the 'normal' text editor
  4006.         keys as usable keys at input fields. This means you can use
  4007.         the arrow keys, Ctrl-T, Ctrl-Y, Insert, Delete, Home and End
  4008.         keys while entering text.
  4009.  
  4010.         11.5      Errorlevels
  4011.         --------------------------------------------------------------
  4012.  
  4013.         SuperBBS normally exits with an errorlevel. You can influence
  4014.         the 'normal' exit through the -Exxx command parameter (see
  4015.         above), but there are some more errorlevels reserved for
  4016.         SuperBBS. Here they are:
  4017.  
  4018.         Errorlevel...: 0
  4019.         Description..: Normal exit, no problems encountered.
  4020.  
  4021.         Errorlevel...: 2
  4022.         Description..: Sysop dropped to DOS by pressing ESCAPE in
  4023.                        stand alone mode.
  4024.  
  4025.         Errorlevel...: 3
  4026.         Description..: User logged off and entered Netmail.
  4027.  
  4028.         Errorlevel...: 4
  4029.         Description..: User logged off and entered Echomail.
  4030.  
  4031.         Errorlevel...: 5
  4032.         Description..: User logged off and entered both Net and Echo-
  4033.                        mail.
  4034.  
  4035.         In general it is useful not to use the errorlevel of 10 and
  4036.         below. These levels are mostly used to control program behav-
  4037.         iour.
  4038.  
  4039.         11.6      Yell and chat
  4040.         --------------------------------------------------------------
  4041.  
  4042.         SuperBBS has a chat option build in to the main program. When
  4043.         a user tries to yell for you, the SuperBBS program will ask
  4044.         for a reason. Then, if a reason is entered, the system will
  4045.         page you. Normally this is a creeping siren sound, but you can
  4046.         choose a melody through the use of YELLCFG.EXE. This program
  4047.         allows you to choose a page melody. You can even write your
  4048.         own tune, check the SBBSYELL.CFG file for an example. If you
  4049.         want to randomly change the tune every day, run the following
  4050.         option in your daily maintenance: YELLCFG.EXE CHANGE. This
  4051.         will take a different melody from the list every time it is
  4052.         run.
  4053.  
  4054.  
  4055.  
  4056.  
  4057.  
  4058.  
  4059.         --------------------------------------------------------------
  4060.         SuperBBS v1.16 - Part B                               Page 168
  4061.  
  4062.  
  4063.         The chat will be in two colours and if ANSI available it will
  4064.         be full screen by default. One window for the Sysop and one
  4065.         for the user. (Naturally only when user has ANSI on.) If the
  4066.         Sysop starts a chat, the user will get all the time spent in
  4067.         the chat back after ending the chat. If the user starts the
  4068.         chat, the time will continue.
  4069.  
  4070.         If you don't want the full screen chat, press the Left-Shift
  4071.         key, while pressing Alt-C or when you answer the chat.
  4072.  
  4073.         SuperBBS will display an ANSI/ASCII file before the user is
  4074.         asked for the reason to chat. This file is called PAGEQUES.A??
  4075.         and should be in your textfile directory.
  4076.  
  4077.         Five keys are available during a chat:
  4078.  
  4079.         Type.........: Ctrl-A
  4080.         Description..: Toggle capture file on/off
  4081.  
  4082.         Type.........: Ctrl-B
  4083.         Description..: Display an ANSI/ASCII file
  4084.  
  4085.         Type.........: Ctrl-Y
  4086.         Description..: Clears current line
  4087.  
  4088.         Type.........: Ctrl-R (in Fullscreen chat)
  4089.         Description..: Redraws the screen
  4090.  
  4091.         Type.........: Ctrl-W (in Fullscreen chat)
  4092.         Description..: Clears the your window
  4093.  
  4094.         The Sysop can end the chat with the ESCAPE key. Through the
  4095.         Ctrl-A key is it possible to keep a capture file for later
  4096.         reviewing of the chat.
  4097.  
  4098.         11.7      Alias system
  4099.         --------------------------------------------------------------
  4100.  
  4101.         SuperBBS allows a full alias system. The Sysop can select the
  4102.         use of an alias in all message areas. (Most echomail areas
  4103.         don't allow aliases.) Mailcheck at logon or after a menu type
  4104.         22 command, will be done for the user's real and alias name.
  4105.         No double aliases are allowed and SuperBBS checks this after a
  4106.         caller enters an alias.
  4107.  
  4108.         SuperBBS includes an option to view a list with real names and
  4109.         their aliases. The alias system only works if you set the
  4110.         option in the CONFIG.EXE program to Yes.
  4111.  
  4112.  
  4113.  
  4114.  
  4115.  
  4116.  
  4117.         --------------------------------------------------------------
  4118.         SuperBBS v1.16 - Part B                               Page 169
  4119.  
  4120.  
  4121.         11.8      View a certain file
  4122.         --------------------------------------------------------------
  4123.  
  4124.         An option in the user record is the field: File to view. Here
  4125.         you can specify per user a file which will be displayed to the
  4126.         user. You can select this file through the use of the
  4127.         BBSUSER.EXE program. There is an option to allow the file to
  4128.         be deleted after viewing and only showing the file once.
  4129.  
  4130.         11.9      Menu to run
  4131.         --------------------------------------------------------------
  4132.  
  4133.         SuperBBS allows users to enter the system at another menu then
  4134.         the TOP.MNU menu. In the SBBSUSER.EXE program is a field for
  4135.         this option. Here you can enter the name of the menu the user
  4136.         wants to start at. SuperBBS will then pass the user directly
  4137.         to the menu given in the MenuToRun field. This menu can be
  4138.         different for every user. There is currently no automatic way
  4139.         to do this. You will have to adjust the userrecord yourself if
  4140.         you want this option available to your users.
  4141.  
  4142.         11.10     Expiration system
  4143.         --------------------------------------------------------------
  4144.  
  4145.         SuperBBS has an expiration system build in. There is a field
  4146.         in the SUSERS.BBS to store the date the expiration has to end.
  4147.         You could use this system to notify members of the expiration
  4148.         of their membership or something like that.
  4149.  
  4150.         When the date of expiration is reached and the user logs on
  4151.         again, he/she will see the questionnaire EXPIRED.Q-A, if
  4152.         available. In this file you can change the userlevel, flag-
  4153.         settings and other information.
  4154.  
  4155.         There is an option to add a certain amount of days to a new-
  4156.         user record. See the configuration part for more information.
  4157.  
  4158.         Two new control codes are available to display the expiration
  4159.         date ^K# and the days till expiration ^F$.
  4160.  
  4161.  
  4162.  
  4163.  
  4164.  
  4165.  
  4166.  
  4167.  
  4168.  
  4169.  
  4170.  
  4171.  
  4172.  
  4173.  
  4174.  
  4175.         --------------------------------------------------------------
  4176.         SuperBBS v1.16 - Part B                               Page 170
  4177.  
  4178.  
  4179.         Chapter 12.    Multitasking and multiline
  4180.         ==============================================================
  4181.  
  4182.         12.1      General information
  4183.         --------------------------------------------------------------
  4184.  
  4185.         SuperBBS is able of running a system with more lines. We
  4186.         ask everybody who uses SuperBBS to give their opinion and
  4187.         ideas. That way we can expand and improve the multi-node
  4188.         option. SuperBBS currently uses 250 KByte memory per line.
  4189.         The setup explained here is for a system running a multitasker
  4190.         like Desqview or a system using a network, although drive
  4191.         names could change in a network configuration.
  4192.  
  4193.         There is a special document available on running multiline
  4194.         systems. Please check your support BBS for this file. It is
  4195.         called: MULTI-SB.xxx (where xxx is the archiver). This docu-
  4196.         ment is by Bob Henderson and contains examples of running a
  4197.         system with Desqview.
  4198.  
  4199.         12.2      Multiline configuration
  4200.         --------------------------------------------------------------
  4201.  
  4202.         The directory setup for the multi-node operations is a bit
  4203.         different from the single line systems. You will have to make
  4204.         a directory for every node you plan to run, even if it's only
  4205.         a local node. Your directory setup could look like this:
  4206.  
  4207.                   C:\SBBS
  4208.                   C:\SBBS\LINE1
  4209.                   C:\SBBS\LINE2
  4210.                   C:\SBBS\LINE3
  4211.                   C:\SBBS\MAIL
  4212.                   C:\SBBS\TEMP1
  4213.                   C:\SBBS\TEMP2
  4214.                   C:\SBBS\TEMP3
  4215.                   C:\SBBS\WORK1
  4216.                   C:\SBBS\WORK2
  4217.                   C:\SBBS\WORK3
  4218.                   C:\SBBS\NODELIST       (Optional)
  4219.                   C:\SBBS\ATTACH         (Optional)
  4220.                   E:\
  4221.  
  4222.         Place the executable programs in the SBBS directory and set
  4223.         your path statement pointing to this directory.
  4224.  
  4225.         You will have to setup a TEMP directory and a WORK directory
  4226.         for every line in use. The E:\ drive is a RAM disk and is the
  4227.         common directory for all nodes. You can also use a normal disk
  4228.         if no RAM drive is available. But a RAM disk is faster.
  4229.  
  4230.  
  4231.  
  4232.  
  4233.         --------------------------------------------------------------
  4234.         SuperBBS v1.16 - Part B                               Page 171
  4235.  
  4236.  
  4237.         Go into the line1 directory and start the config.exe program.
  4238.         The configuration program will start and you can setup all
  4239.         information needed, including file areas and limits. After you
  4240.         have finished, you will find some configuration files in your
  4241.         line1 directory. If you plan to use one single file area
  4242.         configuration list and one single limits configuration list,
  4243.         move the FLSEARCH.CTL and LIMITS.CTL files to the main direc-
  4244.         tory. Their they are accessible by all different lines.
  4245.  
  4246.         Now enter the second line directory and run config again. An
  4247.         option is to copy all files from the line1 directory to the
  4248.         second, third..... directory and then change the settings in
  4249.         the config by running the configuration program. You will have
  4250.         to change at least the directory setup. If using one single
  4251.         FLSEARCH.CTL and LIMITS.CTL file (see above), delete these
  4252.         files created in the line2 and line3.... directories. Config
  4253.         will create the FLSEARCH.CTL and LIMITS.CTL everytime you
  4254.         access the Limits and file area part of the configuration. If
  4255.         you like to change something in the two files, you first have
  4256.         to move them to one of the line directories, otherwise the
  4257.         files are newly created.
  4258.  
  4259.         You will have to create a LANGUAGE.CTL file in every line
  4260.         directory. These can all be the same or can differ from line
  4261.         to line. The *.LNG files you use can all be placed in the main
  4262.         SuperBBS directory.
  4263.  
  4264.         You now have to create the menu and textfiles. This is done in
  4265.         the same way as with a single line, although there are some
  4266.         special points to watch.
  4267.  
  4268.         When using a type 7 exit, you will have to tell the external
  4269.         program which line it is using. Have a look at the type 7
  4270.         optional data menu options for more information on this sub-
  4271.         ject. Most used command would be *N, telling the program which
  4272.         node it is running on. SuperBBS allows the use of the file
  4273.         DORINFO?.DEF, instead of the standard DORINFO1.DEF. The ques-
  4274.         tion mark will be replaced by the node number.
  4275.  
  4276.         When finished with the menus and textfiles, you can try the
  4277.         BBS by going into a line directory and entering BBS -L -N?
  4278.         (where the ? is the line number your working on). This will
  4279.         start the SuperBBS program in local mode on line?.
  4280.  
  4281.         You will now have to setup the multitakser, or the network
  4282.         software, to run the system multiline. Check your manual from
  4283.         the multitasker and/or network for more information on this
  4284.         subject.
  4285.  
  4286.         Please note that some external doors for SuperBBS can't handle
  4287.         the multiline setup. You might have to set up the program
  4288.         separately for every line.
  4289.  
  4290.  
  4291.         --------------------------------------------------------------
  4292.         SuperBBS v1.16 - Part B                               Page 172
  4293.  
  4294.  
  4295.         12.3      Multitaskers & networks
  4296.         --------------------------------------------------------------
  4297.  
  4298.         SuperBBS has been tested with these multitaskers (All trade-
  4299.         marks of their respective owners):
  4300.  
  4301.              - Desqview 2.25 (Normal and 386 versions)
  4302.              - Desqview 2.31
  4303.              - DoubleDos 4.0
  4304.              - Windows 3.0
  4305.              - Windows 3.1 (Beta)
  4306.  
  4307.         SuperBBS support multitasking with Desqview. It will release
  4308.         time slicks and SBBSUSER will ask from Desqview what memory to
  4309.         use for direct screen writes.
  4310.  
  4311.         SuperBBS has been tested with a Lantastic (TM) network and a
  4312.         Novell Light (TM) network.
  4313.  
  4314.         12.4      Message base locking
  4315.         --------------------------------------------------------------
  4316.  
  4317.         SuperBBS has a message base locking system. It is available on
  4318.         request from the SuperBBS headquarters for third party pro-
  4319.         grammers.
  4320.  
  4321.  
  4322.  
  4323.  
  4324.  
  4325.  
  4326.  
  4327.  
  4328.  
  4329.  
  4330.  
  4331.  
  4332.  
  4333.  
  4334.  
  4335.  
  4336.  
  4337.  
  4338.  
  4339.  
  4340.  
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.         --------------------------------------------------------------
  4350.         SuperBBS v1.16 - Part B                               Page 173
  4351.  
  4352.  
  4353.         Chapter 13     External specific SuperBBS utilities
  4354.         ==============================================================
  4355.  
  4356.         13.1      General information.
  4357.         --------------------------------------------------------------
  4358.  
  4359.         SuperBBS comes with a few external programs. These are:
  4360.  
  4361.              - USERPACK.EXE
  4362.              - SBBSUSER.EXE
  4363.              - SBBSUTIL.EXE
  4364.              - SBBSMENU.EXE
  4365.              - STOP.EXE
  4366.              - SBBSNODE.EXE
  4367.              - SNETMGR.EXE
  4368.              - BOARD2CF.EXE
  4369.  
  4370.         These programs are specially written for the use with Super-
  4371.         BBS. Other programs are available, but do not always support
  4372.         all SuperBBS functions.
  4373.  
  4374.         13.2      USERPACK.EXE
  4375.         --------------------------------------------------------------
  4376.  
  4377.         This program is designed to clean your user database. It will
  4378.         delete all users from the USER.BBS and SUSER.BBS files who
  4379.         have the DELETE flag on. The only exception are user's with
  4380.         the NO-KILL flag on. It will also pack your userdatabase for
  4381.         faster processing.
  4382.  
  4383.         Userpack allows multiple commandline parameters, but all
  4384.         parameters are optional. These are the available options:
  4385.  
  4386.         Type.........: -B
  4387.         Description..: Makes backup of the user files. This will take
  4388.                        the program longer to run than without this
  4389.                        option.
  4390.  
  4391.         Type.........: -Dxxx
  4392.         Description..: Deletes users from the list who haven't called
  4393.                        in xxx days.
  4394.  
  4395.         Type.........: -O
  4396.         Description..: Don't make backup copies if there is not enough
  4397.                        diskspace. Use this command in combination with
  4398.                        the -B option.
  4399.  
  4400.         Type.........: -R
  4401.         Description..: Removes backup copies after run is complete.
  4402.  
  4403.         Type.........: -Sxxx
  4404.         Description..: Deletes users with a securitylevel lower than
  4405.                        xxx.
  4406.  
  4407.         --------------------------------------------------------------
  4408.         SuperBBS v1.16 - Part B                               Page 174
  4409.  
  4410.  
  4411.         Type.........: ?
  4412.         Description..: Gives a short help screen. Use only as single
  4413.                        command line option.
  4414.  
  4415.         If you run userpack without any options, it will just pack
  4416.         your user base and delete every user with the DELETE flag on.
  4417.  
  4418.         13.3      SBBSUSER.EXE
  4419.         --------------------------------------------------------------
  4420.  
  4421.         This is the user editor for SuperBBS. You will be able to edit
  4422.         all available information in the user record. It is a full-
  4423.         screen program, with the function keys it uses displayed on
  4424.         the bottom line. Their are two modes (or windows). Edit mode
  4425.         and the main window. Edit mode allows you to change informa-
  4426.         tion from a caller. The main window is the command centre of
  4427.         the program. Here all function keys are active. From here you
  4428.         go to the edit window. These are the available keys:
  4429.  
  4430.         Key..........: Cursor keys
  4431.         Description..: Move around in the editmode of the program.
  4432.                        This will move you from edit field to edit
  4433.                        field.
  4434.  
  4435.         Key..........: Escape
  4436.         Description..: If in editing mode will ask you if you want to
  4437.                        save the information and leave the edit mode.
  4438.                        If in the main window, it will exit you to DOS.
  4439.  
  4440.         Key..........: Home
  4441.         Description..: Will move you to the first user when in the
  4442.                        main window.
  4443.  
  4444.         Key..........: End
  4445.         Description..: Will move you to the last user when in the main
  4446.                        window.
  4447.  
  4448.         Key..........: PgUp
  4449.         Description..: Will move you 10 users forward when in the main
  4450.                        window.
  4451.  
  4452.         Key..........: PgDn
  4453.         Description..: Will move you 10 users backwards when in the
  4454.                        main window.
  4455.  
  4456.         Key..........: F1
  4457.         Description..: Display help screens for SBBSUSER.
  4458.  
  4459.         Key..........: F2
  4460.         Description..: Goto general edit mode. This allows you to
  4461.                        change most information available. Changing the
  4462.                        security level fast is possible with the ALT-S
  4463.                        option.
  4464.  
  4465.         --------------------------------------------------------------
  4466.         SuperBBS v1.16 - Part B                               Page 175
  4467.  
  4468.  
  4469.         Key..........: F3
  4470.         Description..: Search for the user in the NEWUSER.ASW file and
  4471.                        display his/her answers. Useful if you want to
  4472.                        update users.
  4473.  
  4474.         Key..........: F4
  4475.         Description..: Search option. This allows you to search for
  4476.                        part of a name, alias or city.
  4477.  
  4478.         Key..........: F5
  4479.         Description..: Put current user in window in the TRASHCAN.CTL
  4480.                        file.
  4481.  
  4482.         Key..........: F6
  4483.         Description..: Add a new user to the database.
  4484.  
  4485.         Key..........: F7
  4486.         Description..: Change the user's colour configuration.
  4487.  
  4488.         Key..........: F8
  4489.         Description..: Change the user's flagsettings.
  4490.  
  4491.         Key..........: F9
  4492.         Description..: Change the user's attributes. The delete flag
  4493.                        can also be set from the main window through
  4494.                        the ALT-D key.
  4495.  
  4496.         Key..........: F10
  4497.         Description..: Exit the program.
  4498.  
  4499.         Key..........: Shift-F1
  4500.         Description..: Add user to the VIP.CTL list.
  4501.  
  4502.         Key..........: Shift-F4
  4503.         Description..: Change the number of calls
  4504.  
  4505.         With the numerical keys you can select an userrecord. Just
  4506.         enter the number of the record your looking for.
  4507.  
  4508.         SBBSUSER.EXE let's you edit the USER.BBS and SUSER.BBS file.
  4509.         Other user editors mostly allow only editing of the USER.BBS
  4510.         file.
  4511.  
  4512.         13.4      SBBSUTIL.EXE
  4513.         --------------------------------------------------------------
  4514.  
  4515.         SBBSUTIL.EXE allows you to convert some SuperBBS files to
  4516.         general QuickBBS type files. This is useful for some external
  4517.         programs which can't handle the specific SuperBBS type files.
  4518.         The program also gives you the option to initialize your file
  4519.         directories. All commands are done through the use of command-
  4520.         line parameters.
  4521.  
  4522.  
  4523.         --------------------------------------------------------------
  4524.         SuperBBS v1.16 - Part B                               Page 176
  4525.  
  4526.  
  4527.         Start the program as follows:
  4528.  
  4529.              SBBSUTIL.EXE <parameter>
  4530.  
  4531.         The parameters are:
  4532.  
  4533.         Type.........: FLSEARCH
  4534.         Description..: Converts SuperBBS FLSEARCH.BBS to FLSEARCH.CTL,
  4535.                        which can be used with RemoteAccess and/or
  4536.                        QuickBBS utilities.
  4537.  
  4538.         Type.........: LIMITS
  4539.         Description..: Converts SuperBBS LIMITS.BBS to LIMITS.CTL.
  4540.  
  4541.         Type.........: INITFILEAREAS
  4542.         Description..: Will initialize all file areas listed in the
  4543.                        file FLSEARCH.BBS. Here you can use three extra
  4544.                        parameters:
  4545.  
  4546.                             -F   Make FILES.BBS files if not
  4547.                                  available.
  4548.                             -D   Make DIR.BBS files if not available.
  4549.                             -A   Add all missing files, files which
  4550.                                  are in the directory, but not in the
  4551.                                  FILES.BBS list, to the FILES.BBS
  4552.                                  list.
  4553.  
  4554.         Running the util program with the option:
  4555.  
  4556.              SBBSUTIL.EXE <parameter> ?
  4557.  
  4558.         will display a little help screen for the available options.
  4559.  
  4560.         13.5      USERSORT.EXE
  4561.         --------------------------------------------------------------
  4562.  
  4563.         Usersort is a utility to sort your userbase. This can be done
  4564.         in several ways. The available options are:
  4565.  
  4566.              -L   Sort on lastname
  4567.              -F   Sort on firstname
  4568.              -S   Sort on userlevel
  4569.              -D   Sort in descending order
  4570.  
  4571.         Normally ascending sort order is used. The program will take
  4572.         more then one command option.
  4573.  
  4574.  
  4575.         (Continued on next page)
  4576.  
  4577.  
  4578.  
  4579.  
  4580.  
  4581.         --------------------------------------------------------------
  4582.         SuperBBS v1.16 - Part B                               Page 177
  4583.  
  4584.  
  4585.         Example:
  4586.  
  4587.              USERSORT -S -L -F -D
  4588.  
  4589.         will sort your userbase on security, if these are the same on
  4590.         lastname, if these are the same on firstname. It will start at
  4591.         the highest level and will end at the lowest.
  4592.  
  4593.         Note that usersort will also update the LASTREAD.BBS file.
  4594.  
  4595.         13.6      SBBSMENU.EXE
  4596.         --------------------------------------------------------------
  4597.  
  4598.         New with this release of SuperBBS is the SBBSMENU.EXE program.
  4599.         This is a complete menu editor for SuperBBS. It supports the
  4600.         multi-language aspects of SuperBBS. When you start the pro-
  4601.         gram, it should be in your directory containing the configur-
  4602.         ation files, you will be presented with the TOP.MNU menu if
  4603.         available. Otherwise you will start in a new menu.
  4604.  
  4605.         Pressing [ESC] will display the menu. This menu has the fol-
  4606.         lowing options:
  4607.  
  4608.         Command......: Files
  4609.         Description..: Here you will be able to save, load, copy files
  4610.                        and do other maintenance functions.
  4611.  
  4612.         Command......: Text
  4613.         Description..: Here you will find the options which work on
  4614.                        the textpart of the menu.
  4615.  
  4616.         Command......: Commands
  4617.         Description..: Here you will find the options which work on
  4618.                        the menu options from the menu.
  4619.  
  4620.         Command......: Prompt
  4621.         Description..: Commands for the prompt, which will be visible
  4622.                        underneath the menu.
  4623.  
  4624.         Command......: Setup
  4625.         Description..: Setup commands for the menu editor.
  4626.  
  4627.         All menu commands will be described in detail below.
  4628.  
  4629.  
  4630.  
  4631.  
  4632.  
  4633.  
  4634.  
  4635.  
  4636.  
  4637.  
  4638.  
  4639.         --------------------------------------------------------------
  4640.         SuperBBS v1.16 - Part B                               Page 178
  4641.  
  4642.  
  4643.         13.6.1    File commands
  4644.         --------------------------------------------------------------
  4645.  
  4646.         Here are the commands you will find, when you enter the file
  4647.         menu of the SuperBBS menu editor.
  4648.  
  4649.         Command......: Load menu
  4650.         Description..: Loads a menu from the directory specified in
  4651.                        the current language file. You will be pres-
  4652.                        ented with a box stating what to look for.
  4653.                        (Mostly *.MNU files.) Enter the value you want,
  4654.                        or press ENTER and the editor will display a
  4655.                        list of the available menus. With the cursor
  4656.                        keys you can select a file. Pressing ENTER will
  4657.                        load the file.
  4658.  
  4659.         Command......: Save menu
  4660.         Description..: Saves the menu you are currently working on.
  4661.  
  4662.         Command......: New menu
  4663.         Description..: Start building a new menu. The editor will ask
  4664.                        you for a menu name.
  4665.  
  4666.         Command......: Write to
  4667.         Description..: Write the menu file to a specified name. This
  4668.                        option is useful if you want to use a menu to
  4669.                        build another. This way you can save a menu
  4670.                        with a different name.
  4671.  
  4672.         Command......: Rename
  4673.         Description..: Rename a menu in the directory. The editor will
  4674.                        ask you which menu to rename.
  4675.  
  4676.         Command......: Copy
  4677.         Description..: Copies a menu to another name. The editor will
  4678.                        ask you for the name of the menu to copy.
  4679.  
  4680.         Command......: Language
  4681.         Description..: Changes the language currently in use. This
  4682.                        allows you to quickly change menus for all
  4683.                        languages, without leaving the editor.
  4684.  
  4685.         Command......: DOS Shell
  4686.         Description..: Shell temporarily to DOS. You need to type EXIT
  4687.                        to return to the editor from DOS.
  4688.  
  4689.         Command......: Exit to DOS
  4690.         Description..: Exits the menu editor.
  4691.  
  4692.  
  4693.  
  4694.  
  4695.  
  4696.  
  4697.         --------------------------------------------------------------
  4698.         SuperBBS v1.16 - Part B                               Page 179
  4699.  
  4700.  
  4701.         13.6.2    Text commands
  4702.         --------------------------------------------------------------
  4703.  
  4704.         Please note that you now can use the ^Cxxx control code in the
  4705.         menu textfiles to make multicolored textlines. (xxx stands for
  4706.         the colour.)
  4707.  
  4708.         Command......: Edit text
  4709.         Description..: Change the text of the menu. Pressing ALT-F10
  4710.                        while in the text editor will display a help-
  4711.                        file.
  4712.  
  4713.         Command......: Simulate text
  4714.         Description..: The editor will show you what your menu will
  4715.                        look like if a user would see it. You will have
  4716.                        to enter a security level and flagsetting.
  4717.  
  4718.         Command......: Clear text
  4719.         Description..: Clears the current text screen.
  4720.  
  4721.         Command......: View text
  4722.         Description..: View a text belonging to the menu. This option
  4723.                        allows you to see files which are not part of
  4724.                        the menu, but will be displayed through the
  4725.                        ANSI/ASCII display file option in the menu.
  4726.  
  4727.         Command......: Run editor
  4728.         Description..: Enter an ANSI or ASCII text editor as you have
  4729.                        described in the setup of the SuperBBS menu
  4730.                        editor program.
  4731.  
  4732.         When you press ALT-F10 while you are in text edit, a help menu
  4733.         will be displayed. Here you will find all the commands avail-
  4734.         able to you.
  4735.  
  4736.         The use of extended ASCII characters is supported, so you can
  4737.         design lines and other graphics.
  4738.  
  4739.         13.6.3    Menu Commands
  4740.         --------------------------------------------------------------
  4741.  
  4742.         This is the important part of the SuperBBS editor. Here you
  4743.         specify the menu commands. You will find the following com-
  4744.         mands in this menu:
  4745.  
  4746.         Command......: Edit menu
  4747.         Description..: Edit a menu file. Here you enter the menu type,
  4748.                        securitylevel, hotkey and optional data.
  4749.  
  4750.         Command......: Text dump
  4751.         Description..: Dump the text to a printer.
  4752.  
  4753.  
  4754.  
  4755.         --------------------------------------------------------------
  4756.         SuperBBS v1.16 - Part B                               Page 180
  4757.  
  4758.  
  4759.         Command......: Menu dump
  4760.         Description..: Dump the menu information to a printer.
  4761.  
  4762.         When you press ALT-F10 while you are in menu edit, a help menu
  4763.         will be displayed. here you will find all the commands avail-
  4764.         able to you.
  4765.  
  4766.         Entering a menu is done through dialogue boxes for the menu
  4767.         type. If a menu type is not available in the menus given, you
  4768.         can use the option for 'other' menu types.
  4769.  
  4770.         13.6.4    Prompt
  4771.         --------------------------------------------------------------
  4772.  
  4773.         This menu option allows you to edit the prompt which is shown
  4774.         to the user. These commands are available:
  4775.  
  4776.         Command......: Edit prompt
  4777.         Description..: Change the text of the prompt. You can use
  4778.                        control codes in the prompt if you want.
  4779.  
  4780.         Command......: Change colours
  4781.         Description..: Change the colours of the prompt.
  4782.  
  4783.         13.6.5    Setup
  4784.         --------------------------------------------------------------
  4785.  
  4786.         This option allows you to setup the menu editor. You can
  4787.         specify an ANSI and ASCII text editor and the default prompt.
  4788.         The text editors will be called if you want to edit a text-
  4789.         file, so make sure they are in your path, or you specified the
  4790.         complete name.
  4791.  
  4792.         13.7      SBBSNODE.EXE
  4793.         --------------------------------------------------------------
  4794.  
  4795.         As of version 1.15, SuperBBS has nodelist support build in. It
  4796.         isn't a 100 % yet, the cost aspect isn't supported yet, but it
  4797.         is working.
  4798.  
  4799.         Before you can use the nodelist with SuperBBS, you will need
  4800.         to compile two index files. This is done with the SBBSNODE.EXE
  4801.         program. This program will create the files NODEINC.SBS and
  4802.         NODEIDX.SBS. Make sure you have set the directory settings
  4803.         correctly in the configuration program.
  4804.  
  4805.         SBBSNODE.EXE can compile up to 10 different nodelists. It will
  4806.         automatically search for the NODELIST.??? file and compile it.
  4807.         You can give the other files to compile as extra commandline
  4808.         options. Here is an example:
  4809.  
  4810.              SBBSNODE SUPERNET SIGNODES
  4811.  
  4812.  
  4813.         --------------------------------------------------------------
  4814.         SuperBBS v1.16 - Part B                               Page 181
  4815.  
  4816.  
  4817.         This will compile the latest NODELIST.???, SUPERNET.??? and
  4818.         SIGNODES.??? nodelists.
  4819.  
  4820.         Run the nodelist program every time you update your nodelists.
  4821.         This is very important.
  4822.  
  4823.         13.8      SNETMGR.EXE
  4824.         --------------------------------------------------------------
  4825.  
  4826.         This program has two functions. One for multiline systems and
  4827.         one for all systems. When run for the first time, you will be
  4828.         prompted for an ASCII editor, like Q.EXE. If you ever want to
  4829.         change the editor, delete the SNETMGR.CFG file.
  4830.  
  4831.         13.8.1    Users online
  4832.         --------------------------------------------------------------
  4833.  
  4834.         This function of the SNETMGR.EXE program is only of use to
  4835.         multiline systems. It allows you to see the users online in
  4836.         every node, send messages to any combination of users or force
  4837.         any combination of nodes down with a selected errorlevel. The
  4838.         following keys are available:
  4839.  
  4840.              [CURSORKEYS]   Move around the nodes
  4841.  
  4842.              [SPACE]        Tag/untag node
  4843.  
  4844.              [S]            Send message to node
  4845.  
  4846.              [D]            Force node down with errorlevel
  4847.  
  4848.         When forcing a node down, SNETMGR.EXE will ask you for the
  4849.         errorlevel to use to exit. ESCape will return you to the menu.
  4850.  
  4851.         Run the program from the line directories when you are running
  4852.         a multiline system. Otherwise the program will give the error-
  4853.         message that the file SCONFIG.BBS is not found.
  4854.  
  4855.         13.8.2    Last callers
  4856.         --------------------------------------------------------------
  4857.  
  4858.         The second option allows you to view the last 15 callers and
  4859.         today callers of your system. The program can also give you
  4860.         some information about the BPS rates used on your BBS.
  4861.  
  4862.         13.9      BOARD2CF.EXE
  4863.         --------------------------------------------------------------
  4864.  
  4865.         This file will place the message area information contained in
  4866.         the BOARDS.BBS file, into the CONFIG.BBS file, so programs not
  4867.         able to use the BOARDS.BBS file will still be able to read the
  4868.         configuration information they need.
  4869.  
  4870.  
  4871.         --------------------------------------------------------------
  4872.         SuperBBS v1.16 - Part B                               Page 182
  4873.  
  4874.  
  4875.         Chapter 14     Useful information
  4876.         ==============================================================
  4877.  
  4878.         14.1      Batchfiles
  4879.         --------------------------------------------------------------
  4880.  
  4881.         To run SuperBBS you will need a batchfile. Two examples are
  4882.         given. The first is a short one for running SuperBBS in stand
  4883.         alone mode. The second is from a system with a Frontdoor
  4884.         mailer. This is the stand alone version:
  4885.  
  4886.                  @echo off
  4887.                  :start
  4888.                  bbs
  4889.                  if errorlevel 2 goto end
  4890.                  goto start
  4891.  
  4892.                  :end
  4893.                  echo SysOp dropped to dos
  4894.  
  4895.         Nice and simple. Start the batch file and the screen will be
  4896.         cleared. After that SuperBBS is started. If the Sysop presses
  4897.         the ESCAPE key, SuperBBS will exit with errorlevel 2, which
  4898.         will end the batchfile. Otherwise SuperBBS is restarted. See
  4899.         your DOS documentation for more information about batch files
  4900.         and errorlevels. The @echo off only works in DOS 3.3 and
  4901.         higher. Otherwise just leave the @ off.
  4902.  
  4903.         Here's a bigger example. This batchfile is taken from a run-
  4904.         ning system. The system is running SuperBBS with Frontdoor as
  4905.         a mailer and ZmailH as the net/echomail processor.
  4906.  
  4907.         First the CD-Rom is tested. This makes sure the CD-Rom will be
  4908.         available when called upon from SuperBBS. Then Frontdoor is
  4909.         started. Depending on the errorlevel of the exit from Front-
  4910.         door, will the BBS be started or an event will be executed.
  4911.         Errorlevels 117 to 124 represent the different modemspeeds.
  4912.         These errorlevels are set in the configuration program of
  4913.         Frontdoor. Errorlevel 116 is a local logon, executed through
  4914.         the use of a function key in Frontdoor.
  4915.  
  4916.         Errorlevel 110 is executed when it is time for the event,
  4917.         mostly run in the early hours of the day. Errorlevel 125 is
  4918.         used when mail is received by Frontdoor. The system is using
  4919.         two different limits.ctl files, one for the hours between
  4920.         18:00 and 24:00 hours and one for the other time period. They
  4921.         are copied at two events in Frontdoor, errorlevel 105 and 104.
  4922.  
  4923.         The second part in this batchfile with errorlevels is the part
  4924.         where SuperBBS will exit to after a type 15 exit and after the
  4925.         user logged off. Depending on the errorlevel a certain action
  4926.         is taken. If the user logged of, Frontdoor will be started
  4927.         again. If it was a type 15 exit, an external program is
  4928.  
  4929.         --------------------------------------------------------------
  4930.         SuperBBS v1.16 - Part B                               Page 183
  4931.  
  4932.  
  4933.         started. After the external program SuperBBS will restart with
  4934.         the -R option and again return to the errorlevel part when the
  4935.         user logged off, or used another type 15 exit.
  4936.  
  4937.         rem Batchfile NNN SuperBBS - may 1991
  4938.         rem Last revised:  12-06-91
  4939.  
  4940.         @echo off
  4941.         :cdrom
  4942.         dir d:\
  4943.  
  4944.         :start
  4945.         cd\mailer
  4946.         fd.exe
  4947.         if errorlevel 125 goto mail
  4948.         if errorlevel 124 goto 38400bps
  4949.         if errorlevel 123 goto 19200bps
  4950.         if errorlevel 122 goto 38400bps
  4951.         if errorlevel 121 goto 19200bps
  4952.         if errorlevel 120 goto 9600bps
  4953.         if errorlevel 119 goto 4800bps
  4954.         if errorlevel 118 goto 2400bps
  4955.         if errorlevel 117 goto 1200bps
  4956.         if errorlevel 116 goto local
  4957.         if errorlevel 110 goto maint
  4958.         if errorlevel 105 goto avond
  4959.         if errorlevel 104 goto dag
  4960.         if errorlevel  10 goto end
  4961.         if errorlevel   1 goto error
  4962.         goto end
  4963.  
  4964.         :38400bps
  4965.         cd\bbs\line1
  4966.         bbs -N1 -B38400
  4967.         goto afterbbs
  4968.  
  4969.         :19200bps
  4970.         cd\bbs\line1
  4971.         bbs -N1 -B19200
  4972.         goto afterbbs
  4973.  
  4974.         :9600bps
  4975.         cd\bbs\line1
  4976.         bbs -N1 -B9600
  4977.         goto afterbbs
  4978.  
  4979.         :4800bps
  4980.         cd\bbs\line1
  4981.         bbs -N1 -B4800
  4982.         goto afterbbs
  4983.  
  4984.         (Continued on next page)
  4985.  
  4986.  
  4987.         --------------------------------------------------------------
  4988.         SuperBBS v1.16 - Part B                               Page 184
  4989.  
  4990.  
  4991.         :2400bps
  4992.         cd\bbs\line1
  4993.         bbs -N1 -B2400
  4994.         goto afterbbs
  4995.  
  4996.         :1200bps
  4997.         cd\bbs\line1
  4998.         bbs -N1 -B1200
  4999.         goto afterbbs
  5000.  
  5001.         :local
  5002.         cd\bbs\line1
  5003.         bbs -l -N1
  5004.         goto afterbbs
  5005.  
  5006.         :mail
  5007.         echo ath1 > com2
  5008.         cd \bbs
  5009.         zmailh QB PU PI PA PS EI ES EE EF EP NI
  5010.         mbutil link
  5011.         goto start
  5012.  
  5013.         :dag
  5014.         cd \bbs
  5015.         copy tijd1.bbs limits.bbs
  5016.         goto start
  5017.  
  5018.         :avond
  5019.         cd \bbs
  5020.         copy tijd2.bbs limits.bbs
  5021.         goto start
  5022.  
  5023.         :maint
  5024.         echo ath1 > com2
  5025.         cd\bbs
  5026.         copy users.bbs users.fh
  5027.         copy susers.bbs susers.fh
  5028.         mbutil purge -file mbutil.bbs
  5029.         mbutil index -renumber -delete
  5030.         mbutil pack -renumber -overwrite
  5031.         mbutil link
  5032.         zmailh C
  5033.         userpack -D90 -S5
  5034.         usersort -S -F -L -D
  5035.         fast /s
  5036.         maf
  5037.         copy \bbs\line1\config.bbs \bbs\config.bbs
  5038.         dbest c:\bbs\text-uk\top-uplf NNN_SuperBBS 200 u25
  5039.         dbest c:\bbs\text-uk\top-dowf NNN_SuperBBS 200 d25
  5040.         dbest c:\bbs\text-uk\top-uplk NNN_SuperBBS 200 r25
  5041.         dbest c:\bbs\text-uk\top-dowk NNN_SuperBBS 200 s25
  5042.  
  5043.         (Continued on next page)
  5044.  
  5045.         --------------------------------------------------------------
  5046.         SuperBBS v1.16 - Part B                               Page 185
  5047.  
  5048.  
  5049.         dbest c:\bbs\text-uk\top-mess NNN_SuperBBS 200 m25
  5050.         dbest c:\bbs\text-uk\top-area NNN_SuperBBS 200 b25
  5051.         dbest c:\bbs\text-uk\top-syst NNN_SuperBBS 200 i
  5052.         delete \bbs\config.bbs
  5053.         boot
  5054.         goto start
  5055.  
  5056.         :afterbbs
  5057.         if errorlevel 250 goto start
  5058.         if errorlevel 152 goto upload
  5059.         if errorlevel 151 goto download
  5060.         if errorlevel 150 goto xpress
  5061.         if errorlevel   5 goto both
  5062.         if errorlevel   4 goto echomail
  5063.         if errorlevel   3 goto netmail
  5064.         if errorlevel   1 goto end
  5065.         goto start
  5066.  
  5067.         :restartbbs
  5068.         cd\bbs\line1
  5069.         bbs -R -N1
  5070.         goto afterbbs
  5071.  
  5072.         :both
  5073.         echo ath1 > com2
  5074.         cd\bbs
  5075.         zmailh QB EE EF EP PA NE
  5076.         goto start
  5077.  
  5078.         :echomail
  5079.         echo ath1 > com2
  5080.         cd \bbs
  5081.         zmailh QB EE EF EP PA
  5082.         goto start
  5083.  
  5084.         :netmail
  5085.         echo ath1 > com2
  5086.         cd\bbs
  5087.         zmailh QB NE
  5088.         goto start
  5089.  
  5090.         :xpress
  5091.         cd\xpress
  5092.         xpmail -P2 -F -B38400 -DISF -NC
  5093.         goto restartbbs
  5094.  
  5095.         :upload
  5096.         cd\xpress
  5097.         xpmail -P2 -F -B38400 -DISF -NC -U
  5098.         goto restartbbs
  5099.  
  5100.  
  5101.         (Continued on next page)
  5102.  
  5103.         --------------------------------------------------------------
  5104.         SuperBBS v1.16 - Part B                               Page 186
  5105.  
  5106.  
  5107.         :download
  5108.         cd\xpress
  5109.         xpmail -P2 -F -B38400 -DISF -NC -DAP
  5110.         goto restartbbs
  5111.  
  5112.         :error
  5113.         echo Systeem error !!
  5114.  
  5115.         :end
  5116.         echo ath1 > com2
  5117.         echo NNN SuperBBS down.
  5118.  
  5119.         Hope that this example gives you some inside views on running
  5120.         a mailer and SuperBBS. This file is only an example, although
  5121.         it is based upon a running system. Consult your DOS manual for
  5122.         more information on batchfiles. Also found in the documenta-
  5123.         tion of most mailers are examples of running a (Quick)BBS
  5124.         system.
  5125.  
  5126.  
  5127.         14.2      Equipment
  5128.         --------------------------------------------------------------
  5129.  
  5130.         SuperBBS has been tested with a wide variety of machines,
  5131.         ranging from a simple XT to a 80486-33 Mhz, and software,
  5132.         including MS-Dos 5.0 (TM), JP Software 4DOS 4.00 (TM) and
  5133.         Desqview (TM). If you have any trouble running a certain
  5134.         combination of hardware and/or software, contact the support
  5135.         nodes. They might be able to help, or give you information on
  5136.         how to obtain help.
  5137.  
  5138.         14.3      Turbo Pascal errors
  5139.         --------------------------------------------------------------
  5140.  
  5141.         SuperBBS is written in Turbo Pascal. Here are some Turbo
  5142.         Pascal errors. If you receive a message like:
  5143.  
  5144.              Runtime error: ????
  5145.  
  5146.         It means an error occurred. The following list might help you
  5147.         to discover what went wrong.
  5148.  
  5149.         Code.........: 2
  5150.         Description..: File not found
  5151.         Solution.....: You've deleted a SuperBBS file and SuperBBS
  5152.                        can't find it. Check which file is possibly
  5153.                        missing and replace it.
  5154.  
  5155.         Code.........: 3
  5156.         Description..: Path not found
  5157.         Solution.....: You've configured a non existing path in the
  5158.                        configuration. Check your setup.
  5159.  
  5160.  
  5161.         --------------------------------------------------------------
  5162.         SuperBBS v1.16 - Part B                               Page 187
  5163.  
  5164.  
  5165.         Code.........: 4
  5166.         Description..: Too many open files
  5167.         Solution.....: MsDos 'Files=??' statement in config.sys is too
  5168.                        low, increase the value. You will need to re-
  5169.                        boot your computer.
  5170.  
  5171.         Code.........: 5
  5172.         Description..: File access denied
  5173.         Solution.....: You've used a Hidden/ReadOnly attribute with a
  5174.                        SuperBBS file. Don't do that!
  5175.  
  5176.         Code.........: 15
  5177.         Description..: Invalid drive number
  5178.         Solution.....: You've configured an illegal drive in the con-
  5179.                        figuration.
  5180.  
  5181.         Code.........: 100
  5182.         Description..: Disk read error
  5183.         Solution.....: Your hard disk has problems, check it.
  5184.  
  5185.         Code.........: 103
  5186.         Description..: File not open
  5187.         Solution.....: Problems with open/close/read files, try to
  5188.                        increase 'Files=??' statement first.
  5189.  
  5190.         Code.........: 150
  5191.         Description..: Disk write protected
  5192.         Solution.....: You've a write protected disk, don't do that.
  5193.  
  5194.         Code.........: 151
  5195.         Description..: Unknown unit
  5196.         Solution.....: You've configured an illegal unit/drive in the
  5197.                        configuration.
  5198.  
  5199.         Code.........: 152
  5200.         Description..: Drive not ready
  5201.         Solution.....: Problems with your disk drive, check it.
  5202.  
  5203.         Code.........: 156
  5204.         Description..: Disk seek error
  5205.         Solution.....: Problems with your disk drive, check it.
  5206.  
  5207.         Code.........: 157
  5208.         Description..: Unknown media type
  5209.         Solution.....: Operating system doesn't recognize your disk
  5210.                        drive's format. Check it.
  5211.  
  5212.         Code.........: 158
  5213.         Description..: Sector not found
  5214.         Solution.....: Problems with your disk drive, check it.
  5215.  
  5216.  
  5217.  
  5218.  
  5219.         --------------------------------------------------------------
  5220.         SuperBBS v1.16 - Part B                               Page 188
  5221.  
  5222.  
  5223.         Code.........: 162
  5224.         Description..: Hardware failure
  5225.         Solution.....: Problems with your hardware, check it.
  5226.  
  5227.         Code.........: 200
  5228.         Description..: Division by zero
  5229.         Solution.....: Program error, inform authors.
  5230.  
  5231.         Code.........: 202
  5232.         Description..: Stack overflow error
  5233.         Solution.....: Program error, inform authors.
  5234.  
  5235.         That's it. For more information about these errors, refer to
  5236.         the Turbo Pascal manuals, or contact the nearest SuperBBS help
  5237.         support or the authors.
  5238.  
  5239.         14.4      Credits
  5240.         --------------------------------------------------------------
  5241.  
  5242.         All names and programs mentioned in this documentation are
  5243.         copyrighted by their owners. Please observe the rules to use
  5244.         these programs and register them if needed. Shareware can't
  5245.         live without your support. Do not use illegally obtained soft-
  5246.         ware.
  5247.  
  5248.         We thank every writer of software available to SuperBBS for
  5249.         his/her contribution. Keep up the good work!
  5250.  
  5251.  
  5252.  
  5253.  
  5254.  
  5255.  
  5256.  
  5257.  
  5258.  
  5259.  
  5260.  
  5261.  
  5262.  
  5263.  
  5264.  
  5265.  
  5266.  
  5267.  
  5268.  
  5269.  
  5270.  
  5271.  
  5272.  
  5273.  
  5274.  
  5275.  
  5276.  
  5277.         --------------------------------------------------------------
  5278.         SuperBBS v1.16 - Part B                               Page 189
  5279.  
  5280.  
  5281.         Chapter 15     SuperNet
  5282.         ==============================================================
  5283.  
  5284.         SuperNet is an elite network joining SuperBBS bulletin board
  5285.         systems all over the world. It is a direct connection to the
  5286.         SuperBBS group, documentation writer and users alike to dis-
  5287.         cuss SuperBBS operations and development, watch for program
  5288.         and utilities updates or just a place to chat about SuperBBS.
  5289.         SuperNet will make a nice addition to your local SuperBBS
  5290.         bulletin board system.
  5291.  
  5292.         Currently SuperNet is available in the following countries:
  5293.  
  5294.              - Finland
  5295.              - Sweden
  5296.              - Denmark
  5297.              - Norway
  5298.              - USA
  5299.              - Canada
  5300.              - Germany
  5301.              - The Netherlands
  5302.              - Japan
  5303.              - Taiwan
  5304.              - Switzerland
  5305.  
  5306.         For more information concerning SuperNet, send a Crash netmail
  5307.         to SuperBBS Support Sweden, Fidonet 2:203/111 or SuperNet
  5308.         42:1003/101, telephone **.46.31.312461. Poll again 24 hours
  5309.         later for a reply. Or you can contact a SuperBBS system con-
  5310.         nected to SuperNet in a country already connected.
  5311.  
  5312.         SuperNet nodes are using the 42:xxxx/xxxx node numbers. The
  5313.         Northern America sites are using net 43 for their nodenumbers.
  5314.         Net 44 is used for the BBS nodes in Japan and Taiwan.
  5315.  
  5316.         Most SuperNet systems have the nodelist available for down-
  5317.         load. Ask a SuperBBS Support site for one, if you can't find
  5318.         a nodelist from SuperNet near you.
  5319.  
  5320.         There are several echomail areas available in SuperNet. Most
  5321.         of these areas are available to all users and Sysops of the
  5322.         Bulletin Board System.
  5323.  
  5324.         Here's a short overview:
  5325.  
  5326.         Area.........: SBBS_INT
  5327.         Description..: SuperNet echomail about all kinds of subjects,
  5328.                        not necessarily about SuperBBS.
  5329.         Available to.: Sysops and users
  5330.  
  5331.  
  5332.  
  5333.  
  5334.  
  5335.         --------------------------------------------------------------
  5336.         SuperBBS v1.16 - Part B                               Page 190
  5337.  
  5338.  
  5339.         Area.........: Superthoughts
  5340.         Description..: SuperNet echomail for chit chat. Subject is
  5341.                        free. (Except for personal attacks and commer-
  5342.                        cials).
  5343.         Available to.: Sysops and users
  5344.  
  5345.         Area.........: SBBS_BUGS
  5346.         Description..: SuperNet echomail for reporting bugs in Super-
  5347.                        BBS. Replies can be given as long they concern
  5348.                        the subject.
  5349.         Available to.: Sysops (write access)
  5350.  
  5351.         Area.........: SBBS_TIPS
  5352.         Description..: SuperNet echomail for tips and hints about
  5353.                        SuperBBS. Replies can be given as long they
  5354.                        concern the subject.
  5355.         Available to.: Sysops (write access)
  5356.  
  5357.         Area.........: SNET_INT
  5358.         Description..: SuperNet READ ONLY echomail area with news from
  5359.                        the SuperNet coordinators and the SuperBBS
  5360.                        team.
  5361.         Available to.: Sysops (READ ONLY)
  5362.  
  5363.         More areas are available, this is only a small sample of the
  5364.         current areas. Most countries have their own national echomail
  5365.         areas available.
  5366.  
  5367.         Join an elite network, join SuperNet!
  5368.  
  5369.  
  5370.  
  5371.  
  5372.  
  5373.  
  5374.  
  5375.  
  5376.  
  5377.  
  5378.  
  5379.  
  5380.  
  5381.  
  5382.  
  5383.  
  5384.  
  5385.  
  5386.  
  5387.  
  5388.  
  5389.  
  5390.  
  5391.  
  5392.  
  5393.         --------------------------------------------------------------
  5394.         SuperBBS v1.16 - Part B                               Page 191
  5395.  
  5396.  
  5397.         Appendix A     Menu list
  5398.         ==============================================================
  5399.  
  5400.         Menu    Description                                     Page
  5401.         ------  ----------------------------------------------  ------
  5402.          0      Text line                                       102
  5403.          1      Goto new menu                                   103
  5404.          2      Gosub new menu                                  103
  5405.          3      Return from last gosub                          103
  5406.          4      Goto new menu and clear gosub stack             104
  5407.          5      Display .ANS/.ASC file                          104
  5408.          6      Selection menu                                  104
  5409.          7      Shell to dos                                    105
  5410.          8      Version and copyright notice                    106
  5411.          9      Logoff from system                              107
  5412.         10      Display system usage graph                      107
  5413.         11      Page the Sysop                                  107
  5414.         12      Execute questionnaire                           107
  5415.         13      List/search userlist                            108
  5416.         14      Time statistics                                 108
  5417.         15      Exit to DOS with errorlevel                     108
  5418.         16      Change city and state                           108
  5419.         17      Change password                                 108
  5420.         18      Change screenlength                             109
  5421.         19      Toggle screen clearing                          109
  5422.         20      Toggle more prompt                              109
  5423.         21      Toggle ANSI graphics                            109
  5424.         22      Scan for personal mail                          109
  5425.         23      Read messages                                   109
  5426.         24      Scan messages                                   110
  5427.         25      Quick scan messages                             110
  5428.         26      Delete messages                                 110
  5429.         27      Write messages                                  110
  5430.         28      Select combined message areas                   111
  5431.         29      Move a file                                     111
  5432.         30      MS-Dos directory list                           111
  5433.         31      List FILES.BBS                                  111
  5434.         32      Download file                                   112
  5435.         33      Upload file                                     112
  5436.         34      View archived file                              112
  5437.         35      Search for file by keyword                      112
  5438.         36      Search for file by filename                     112
  5439.         37      List new files on system                        113
  5440.         38      Type a textfile                                 113
  5441.         39      Display a textfile                              113
  5442.         40      Display .ANS/.ASC file with Hotkey enabled      113
  5443.         41      Toggle fullscreen editor                        114
  5444.         42      RESERVED - Do not use
  5445.         43      RESERVED - Do not use
  5446.         44      RESERVED - Do not use
  5447.         45      Display .ANS/.ASC file with 'Press ENTER'       114
  5448.         46      Show GIF resolution                             114
  5449.  
  5450.  
  5451.         --------------------------------------------------------------
  5452.         SuperBBS v1.16 - Part B                               Page 192
  5453.  
  5454.         47      Write entry in system logfile                   114
  5455.         48      Download specific file                          115
  5456.         49      RESERVED - Do not use
  5457.         50      RESERVED - Do not use
  5458.         51      RESERVED - Do not use
  5459.         52      RESERVED - Do not use
  5460.         53      Toggle mailcheck at logon                       115
  5461.         54      Toggle newfiles check at logon                  115
  5462.         55      Show BBS list (Short)                           115
  5463.         56      Add BBS to BBS list                             115
  5464.         57      Leave comment for next user                     116
  5465.         58      Show callers                                    116
  5466.         59      Change colour configuration                     116
  5467.         60      Extract files                                   116
  5468.         61      Archive files                                   117
  5469.         62      Delete files                                    117
  5470.         63      Show BBS list (Long)                            117
  5471.         64      Change BBS information in BBS list              117
  5472.         65      Delete BBS information in BBS list              117
  5473.         66      Download BBS list                               117
  5474.         67      Change user's phonenumber(s)                    118
  5475.         68      Select message area from list                   118
  5476.         69      Select/Pick file area from list                 119
  5477.         70      Change alias                                    119
  5478.         71      List aliases                                    119
  5479.         72      Show user's balance in timebank                 119
  5480.         73      Deposit time in timebank                        119
  5481.         74      Withdraw time from timebank                     119
  5482.         75      User online                                     120
  5483.         76      Send message to other line                      120
  5484.         77      Change current language                         120
  5485.         78      Toggle 'Do not disturb' flag                    120
  5486.         79      Toggle fullscreen message viewer                120
  5487.         80      Display areas with unread mail                  120
  5488.         81      Perform viruscheck                              121
  5489.         82      QWK download                                    121
  5490.         83      QWK upload                                      121
  5491.         84      Update lastread pointer                         121
  5492.         85      Show aphorism                                   121
  5493.         86      Execute doornumber                              122
  5494.         87      Select door from list                           122
  5495.         88      Browse nodelist                                 122
  5496.         89      Area by area read                               123
  5497.         90      Attach file to user                             123
  5498.         91      Check for attached files                        123
  5499.         92      Select QWK archiver                             123
  5500.         93      Sysop download                                  123
  5501.         94      Show age graph                                  124
  5502.         95      Remove/List flagged files                       124
  5503.         96      Toggle selected area read                       124
  5504.         97      Select default protocol                         124
  5505.         98      Toggle hotkeys                                  124
  5506.         99      Chat between nodes                              124
  5507.         100     Create chat conference                          125
  5508.  
  5509.         --------------------------------------------------------------
  5510.         SuperBBS v1.16 - Part B                               Page 193
  5511.  
  5512.  
  5513.         Appendix B     Bugreport and Suggestion form
  5514.         ==============================================================
  5515.  
  5516.         Suggestions form. Send this to the SuperBBS HQ in Finland.
  5517.  
  5518.         Date..................:   ... - ... - 19 ...
  5519.  
  5520.         Name..................:   ____________________________________
  5521.  
  5522.         Address...............:   ____________________________________
  5523.  
  5524.                                   ____________________________________
  5525.  
  5526.                                   ____________________________________
  5527.  
  5528.         BBS name..............:   ____________________________________
  5529.  
  5530.         BBS telephone nr......:   ____________________________________
  5531.  
  5532.         My suggestion is :
  5533.  
  5534.         ______________________________________________________________
  5535.  
  5536.         ______________________________________________________________
  5537.  
  5538.         ______________________________________________________________
  5539.  
  5540.         ______________________________________________________________
  5541.  
  5542.         ______________________________________________________________
  5543.  
  5544.         ______________________________________________________________
  5545.  
  5546.         ______________________________________________________________
  5547.  
  5548.         ______________________________________________________________
  5549.  
  5550.         ______________________________________________________________
  5551.  
  5552.         ______________________________________________________________
  5553.  
  5554.         ______________________________________________________________
  5555.  
  5556.         ______________________________________________________________
  5557.  
  5558.         ______________________________________________________________
  5559.  
  5560.         ______________________________________________________________
  5561.  
  5562.  
  5563.  
  5564.  
  5565.  
  5566.  
  5567.         --------------------------------------------------------------
  5568.         SuperBBS v1.16 - Part B                               Page 194
  5569.  
  5570.  
  5571.         Bugreport form. Send this to the SuperBBS HQ in Finland.
  5572.  
  5573.         Date..................:   ... - ... - 19 ...
  5574.  
  5575.         Name..................:   ____________________________________
  5576.  
  5577.         Address...............:   ____________________________________
  5578.  
  5579.                                   ____________________________________
  5580.  
  5581.                                   ____________________________________
  5582.  
  5583.         BBS name..............:   ____________________________________
  5584.  
  5585.         BBS telephone nr......:   ____________________________________
  5586.  
  5587.         The bug found is :          (Please be as clearly as possible)
  5588.  
  5589.         ______________________________________________________________
  5590.  
  5591.         ______________________________________________________________
  5592.  
  5593.         ______________________________________________________________
  5594.  
  5595.         ______________________________________________________________
  5596.  
  5597.         ______________________________________________________________
  5598.  
  5599.         ______________________________________________________________
  5600.  
  5601.         ______________________________________________________________
  5602.  
  5603.         ______________________________________________________________
  5604.  
  5605.         ______________________________________________________________
  5606.  
  5607.         ______________________________________________________________
  5608.  
  5609.         ______________________________________________________________
  5610.  
  5611.         ______________________________________________________________
  5612.  
  5613.         ______________________________________________________________
  5614.  
  5615.         ______________________________________________________________
  5616.  
  5617.  
  5618.  
  5619.  
  5620.  
  5621.  
  5622.  
  5623.  
  5624.  
  5625.         --------------------------------------------------------------
  5626.         SuperBBS v1.16 - Part B                               Page 195
  5627.  
  5628.  
  5629.  
  5630.  
  5631.  
  5632.  
  5633.  
  5634.  
  5635.  
  5636.  
  5637.  
  5638.  
  5639.  
  5640.  
  5641.  
  5642.  
  5643.  
  5644.  
  5645.  
  5646.  
  5647.             << END OF DOCUMENTATTION FOR SUPERBBS VERSION 1.16 >>
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.  
  5654.  
  5655.  
  5656.  
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.  
  5663.  
  5664.  
  5665.  
  5666.  
  5667.  
  5668.  
  5669.  
  5670.  
  5671.  
  5672.  
  5673.  
  5674.  
  5675.  
  5676.  
  5677.  
  5678.  
  5679.  
  5680.  
  5681.  
  5682.  
  5683.         --------------------------------------------------------------
  5684.         SuperBBS v1.16 - Part B                               Page 196
  5685.